Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit ad2eb9f

Browse files
erikmarrerikmarr
authored
Merge branch 'master' into patch-6
2 parents c265d0d + 1166b78 commit ad2eb9f

File tree

25 files changed

+418
-286
lines changed

25 files changed

+418
-286
lines changed

‎_data/whats-new.yml

Lines changed: 79 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,86 @@ description: |
44
We exclude from this list proofreading, spelling checks, and all minor updates.
55
link: /whats-new.html
66
thread: /whatsnew-feed.xml
7-
updated: 2019-01-22 14:30:23 -0600
7+
updated: Mon Feb 4 13:40:53 2019
88
entries:
9+
- description: Added information about domain- versus presentation-specific logic
10+
to the [Technical Guidelines](https://devdocs.magento.com/guides/v2.3/coding-standards/technical-guidelines.html).
11+
versions: 2.x
12+
type: Major update
13+
date: February 4, 2019
14+
link: https://github.com/magento/devdocs/pull/3316
15+
- description: Clarified the process for creating the [magento_umask](https://devdocs.magento.com/guides/v2.3/install-gde/install/post-install-umask.html)
16+
file.
17+
versions: 2.1.x, 2.2.x, 2.3.x
18+
type: Technical changes
19+
date: January 31, 2019
20+
link: https://github.com/magento/devdocs/pull/3667
21+
- description: Removed incorrect information about changes to deploy phase validation
22+
checks in the Magento Commerce Cloud [Release notes for ece-tools, v2002.0.14](https://devdocs.magento.com/guides/v2.3/cloud/release-notes/cloud-tools.html#v2002014).
23+
versions: 2.1.x, 2.2.x, 2.3.x
24+
type: Technical changes
25+
date: January 31, 2019
26+
link: https://github.com/magento/devdocs/pull/3664
27+
- description: Corrected the command syntax in the [log preparation instructions](https://devdocs.magento.com/guides/v2.3/cloud/project/project-integrate-blackfire.html#blackfire-support) for
28+
troubleshooting Blackfire issues.
29+
versions: 2.x
30+
type: Technical changes
31+
date: January 30, 2019
32+
link: https://github.com/magento/devdocs/pull/3586
33+
- description: Adds two new PWA actions to the Actions reference guide for the MFTF
34+
2.3.13 release:<br/>[waitforPwaElementNotVisibleType](https://devdocs.magento.com/mftf/2.3/test/actions.html#waitforpwaelementnotvisible)<br/>[waitforPwaElementVisibleType](https://devdocs.magento.com/mftf/2.3/test/actions.html#waitforpwaelementvisible)
35+
versions: 2.3.x
36+
type: Major update
37+
date: January 29, 2019
38+
link: https://github.com/magento/devdocs/pull/3633
39+
- description: Added a new REST tutorial about using the bulk API.
40+
versions: 2.3.x
41+
type: New topic
42+
date: January 29, 2019
43+
link: https://github.com/magento/devdocs/pull/3580
44+
- description: Adds a new [Tips and Tricks](https://devdocs.magento.com/mftf/2.3/tips-tricks.html)
45+
page to the MFTF guide.
46+
versions: 2.3.1
47+
type: New topic
48+
date: January 29, 2019
49+
link: https://github.com/magento/devdocs/pull/3635
50+
- description: Added [new tutorial](https://devdocs.magento.com/guides/v2.3/rest/tutorials/bulk-configurable-product/config-product-intro.html)
51+
about how to use the REST bulk API.
52+
versions: 2.3.x
53+
type: New topic
54+
date: January 29, 2019
55+
link: https://github.com/magento/devdocs/pull/3638
56+
- description: Added Inventory Management service names to the [SOAP Reference](https://devdocs.magento.com/guides/v2.3/soap/bk-soap.html)
57+
versions: 2.3.x
58+
type: Major update
59+
date: January 28, 2019
60+
link: https://github.com/magento/devdocs/pull/3630
61+
- description: "[Corrected the route](https://devdocs.magento.com/guides/v2.3/rest/list.html)
62+
of the `POST /V1/inventory/low-quantity-notifications-delete` endpoint."
63+
versions: 2.3.x
64+
type: Technical changes
65+
date: January 28, 2019
66+
link: https://github.com/magento/devdocs/pull/3627
67+
- description: Updated Magento Commerce and Magento Commerce Cloud release information
68+
to remove obsolete topics and add links to current Magento Commerce Cloud release
69+
information in [Release Notes for ece-tools](https://devdocs.magento.com/guides/v2.3/cloud/release-notes/cloud-tools.html).
70+
versions: 2.x
71+
type: Major update
72+
date: January 24, 2019
73+
link: https://github.com/magento/devdocs/pull/3595
74+
- description: Updated the Magento Commerce Cloud Release Information with link to
75+
Magento Commerce Cloud release information in the [Release Notes for ece-tools](https://devdocs.magento.com/guides/v2.3/cloud/release-notes/cloud-tools.html)
76+
topic.
77+
versions: 2.3.x
78+
type: Technical changes
79+
date: January 23, 2019
80+
link: https://github.com/magento/devdocs/pull/3603
81+
- description: Corrected the name of the Magento Commerce Cloud Staging and Production
82+
deploy log.
83+
versions: 2.1.x, 2.2.x, 2.3.x
84+
type: Technical changes
85+
date: January 23, 2019
86+
link: https://github.com/magento/devdocs/pull/3611
987
- description: Added a [section](https://devdocs.magento.com/guides/v2.3/install-gde/trouble/php/tshoot_php-set.html#max-input-vars-error-due-to-large-forms)
1088
discussing the max-input-vars value in php.ini.
1189
versions: 2.1.x, 2.2.x, 2.3.x

‎_includes/webapi/services21.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,22 @@
22

33
The Web APIs for {{site.data.var.ee}} are available on Commerce installations only. Commerce installations automatically have access to all {{site.data.var.ce}} REST APIs.
44

5-
### Customer balance
5+
### CustomerBalance
66
customerBalanceBalanceManagementV1
77

8-
### Gift cards
8+
### GiftCardAccount
99
giftCardAccountGiftCardAccountManagementV1
1010
giftCardAccountGuestGiftCardAccountManagementV1
1111
giftRegistryGuestCartShippingMethodManagementV1
1212
giftRegistryShippingMethodManagementV1
1313

14-
### Gift wrapping
14+
### GiftWrapping
1515
giftWrappingWrappingRepositoryV1
1616

1717
### Reward
1818
rewardRewardManagementV1
1919

20-
### RMA
20+
### Rma
2121
rmaCommentManagementV1
2222
rmaRmaAttributesManagementV1
2323
rmaRmaManagementV1
@@ -35,7 +35,7 @@ The Web APIs for {{site.data.var.ee}} are available on Commerce installations on
3535
### Backend
3636
backendModuleServiceV1
3737

38-
### Bundle product
38+
### Bundle
3939
bundleProductLinkManagementV1
4040
bundleProductOptionManagementV1
4141
bundleProductOptionRepositoryV1
@@ -67,7 +67,7 @@ The Web APIs for {{site.data.var.ee}} are available on Commerce installations on
6767
catalogProductTypeListV1
6868
catalogProductWebsiteLinkRepositoryV1
6969

70-
### Catalog inventory
70+
### CatalogInventory
7171
catalogInventoryStockRegistryV1
7272

7373
### Checkout
@@ -78,14 +78,14 @@ The Web APIs for {{site.data.var.ee}} are available on Commerce installations on
7878
checkoutShippingInformationManagementV1
7979
checkoutTotalsInformationManagementV1
8080

81-
### Checkout agreements
81+
### CheckoutAgreements
8282
checkoutAgreementsCheckoutAgreementsRepositoryV1
8383

84-
### CMS
84+
### Cms
8585
cmsBlockRepositoryV1
8686
cmsPageRepositoryV1
8787

88-
### Configurable product
88+
### ConfigurableProduct
8989
configurableProductConfigurableProductManagementV1
9090
configurableProductLinkManagementV1
9191
configurableProductOptionRepositoryV1
@@ -107,11 +107,11 @@ The Web APIs for {{site.data.var.ee}} are available on Commerce installations on
107107
downloadableLinkRepositoryV1
108108
downloadableSampleRepositoryV1
109109

110-
### EAV
110+
### Eav
111111
eavAttributeSetManagementV1
112112
eavAttributeSetRepositoryV1
113113

114-
### Gift message
114+
### GiftMessage
115115
giftMessageCartRepositoryV1
116116
giftMessageGuestCartRepositoryV1
117117
giftMessageGuestItemRepositoryV1
@@ -164,7 +164,7 @@ The Web APIs for {{site.data.var.ee}} are available on Commerce installations on
164164
salesShipOrderV1
165165
salesTransactionRepositoryV1
166166

167-
### Sales rule
167+
### SalesRule
168168
salesRuleCouponManagementV1
169169
salesRuleCouponRepositoryV1
170170
salesRuleRuleRepositoryV1

‎_includes/webapi/services22.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,22 @@
22

33
The Web APIs for {{site.data.var.ee}} (formerly Magento Enterprise Edition) are available on {{site.data.var.ee}} installations only. {{site.data.var.ee}} installations automatically have access to all {{site.data.var.ce}} (formerly Magento Community Edition) web APIs.
44

5-
### Customer balance
5+
### CustomerBalance
66
customerBalanceBalanceManagementV1
77

8-
### Gift cards
8+
### GiftCardAccount
99
giftCardAccountGiftCardAccountManagementV1
1010
giftCardAccountGuestGiftCardAccountManagementV1
1111
giftRegistryGuestCartShippingMethodManagementV1
1212
giftRegistryShippingMethodManagementV1
1313

14-
### Gift wrapping
14+
### GiftWrapping
1515
giftWrappingWrappingRepositoryV1
1616

1717
### Reward
1818
rewardRewardManagementV1
1919

20-
### RMA
20+
### Rma
2121
rmaCommentManagementV1
2222
rmaRmaAttributesManagementV1
2323
rmaRmaManagementV1
@@ -76,7 +76,7 @@ The Web APIs for {{site.data.var.ee}} (formerly Magento Enterprise Edition) are
7676
catalogSpecialPriceStorageV1 *
7777
catalogTierPriceStorageV1 *
7878

79-
### Catalog inventory
79+
### CatalogInventory
8080
catalogInventoryStockRegistryV1
8181

8282
### Checkout
@@ -87,14 +87,14 @@ The Web APIs for {{site.data.var.ee}} (formerly Magento Enterprise Edition) are
8787
checkoutShippingInformationManagementV1
8888
checkoutTotalsInformationManagementV1
8989

90-
### Checkout agreements
90+
### CheckoutAgreements
9191
checkoutAgreementsCheckoutAgreementsRepositoryV1
9292

93-
### CMS
93+
### Cms
9494
cmsBlockRepositoryV1
9595
cmsPageRepositoryV1
9696

97-
### Configurable product
97+
### ConfigurableProduct
9898
configurableProductConfigurableProductManagementV1
9999
configurableProductLinkManagementV1
100100
configurableProductOptionRepositoryV1
@@ -116,11 +116,11 @@ The Web APIs for {{site.data.var.ee}} (formerly Magento Enterprise Edition) are
116116
downloadableLinkRepositoryV1
117117
downloadableSampleRepositoryV1
118118

119-
### EAV
119+
### Eav
120120
eavAttributeSetManagementV1
121121
eavAttributeSetRepositoryV1
122122

123-
### Gift message
123+
### GiftMessage
124124
giftMessageCartRepositoryV1
125125
giftMessageGuestCartRepositoryV1
126126
giftMessageGuestItemRepositoryV1
@@ -173,7 +173,7 @@ The Web APIs for {{site.data.var.ee}} (formerly Magento Enterprise Edition) are
173173
salesShipOrderV1
174174
salesTransactionRepositoryV1
175175

176-
### Sales rule
176+
### SalesRule
177177
salesRuleCouponManagementV1
178178
salesRuleCouponRepositoryV1
179179
salesRuleRuleRepositoryV1

‎community/resources/best-practices.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,16 @@ They are available in DevDocs because the content has been well received within
2121

2222
The DevDocs and Magento teams verified and provide the following best practices and recommendations:
2323

24-
- [Best Practices and Benchmarking](https://devdocs.magento.com/guides/v2.2/migration/migration-overview-practices.html) for Migration
25-
- [Best Practices for Extension Development](https://devdocs.magento.com/guides/v2.2/ext-best-practices/bk-ext-best-practices.html)
24+
- [Best Practices and Benchmarking](https://devdocs.magento.com/guides/v2.3/migration/migration-overview-practices.html) for Migration
25+
- [Best Practices for Extension Development](https://devdocs.magento.com/guides/v2.3/ext-best-practices/bk-ext-best-practices.html)
2626

2727
We also recommend the [Magento Marketplace Help Center](https://marketplacesupport.magento.com/hc/en-us) for extension questions.
28-
- [Programming Best Practices](https://devdocs.magento.com/guides/v2.2/ext-best-practices/extension-coding/common-programming-bp.html)
29-
- [Observers Best Practices](https://devdocs.magento.com/guides/v2.2/ext-best-practices/extension-coding/observers-bp.html)
30-
- [Theme development best practices](https://devdocs.magento.com/guides/v2.2/frontend-dev-guide/theme-best-practice.html)
31-
- [Performance Best Practices](https://devdocs.magento.com/guides/v2.2/performance-best-practices/)
32-
- [Best Practices for Store Configuration](https://devdocs.magento.com/guides/v2.2/cloud/configure/configure-best-practices.html) for Commerce Cloud
33-
- [Deployment process](https://devdocs.magento.com/guides/v2.2/cloud/reference/discover-deploy.html) for Commerce Cloud
28+
- [Programming Best Practices](https://devdocs.magento.com/guides/v2.3/ext-best-practices/extension-coding/common-programming-bp.html)
29+
- [Observers Best Practices](https://devdocs.magento.com/guides/v2.3/ext-best-practices/extension-coding/observers-bp.html)
30+
- [Theme Development Best Practices](https://devdocs.magento.com/guides/v2.3/frontend-dev-guide/theme-best-practice.html)
31+
- [Performance Best Practices](https://devdocs.magento.com/guides/v2.3/performance-best-practices/)
32+
- [Best Practices for Store Configuration](https://devdocs.magento.com/guides/v2.3/cloud/configure/configure-best-practices.html) for Commerce Cloud
33+
- [Deployment Process](https://devdocs.magento.com/guides/v2.3/cloud/reference/discover-deploy.html) for Commerce Cloud
3434

3535
## Want to contribute?
3636

‎community/resources/resources.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This Community collection of resources links to blog posts, podcasts, presentati
99

1010
New items will be added incrementally, and older links rotated out. Keep an eye on this space for the latest community resources!
1111

12-
Another community-based resource, focused on describing the Magento 2 Environment is the [Magento 2 Awesome List][0]
12+
Another community-based resource, focused on describing the Magento 2 environment, is the [Magento 2 Awesome List][0].
1313

1414
Do you know of a popular resource about Magento 2 that has been released/published within the past year?
1515
Does it fill gaps in our current docs and provide important information?
@@ -25,19 +25,24 @@ See our collection of best and leading practices, common solutions, and more in
2525

2626
## Community Engineering Slack
2727

28-
To connect with Magento and the Community, join us on the [Magento Community Engineering Slack][]. If you are interested in joining Slack, or a specific channel, send us a request at [[email protected]](mailto:[email protected]) or [self signup][].
28+
To connect with Magento and the Community, join us on the [Magento Community Engineering Slack][]. If you are interested in joining Slack, or a specific channel, send us a request at [[email protected]](mailto:[email protected]) or [self signup][].
2929

3030

3131
We have channels for each project. These channels are recommended for new members:
3232

33+
- [announcements][]: Introduce yourself and get quick updates for Magento Community Engineering
3334
- [general][]: Open chat for introductions and Magento 2 questions
35+
- [appdesign][]: Open chat for Magento architecture and [technical guidelines][]
36+
- [coding-standards][]: Open chat for developing [coding standards][] for Magento
3437
- [github][]: Support for GitHub issues, pull requests, and processes
3538
- [public-backlog][]: Discussions of the Magento 2 backlog
3639
- [devdocs][]: Documentation contribution support
3740

3841
## Resources and guides
3942

43+
- *Video* [How to contribute during Magento Contribution Days][57] by [Max Pronko][35]
4044
- *GitHub* [Magento Resources][23] curated list by [Alessandro Ronchi][30]
45+
- *Blog posts* [Thoughts on Magento, PHP, JavaScript, Laravel, React, Docker, and user interface design][56] by [Mark Shust][38]
4146
- *Videos* [Mage2.tv][24]
4247
- *Podcast* [MageTalk][25] by [Phillip Jackson and Kalen][27]
4348
- *Vlog* [eCommerceAholic][26] by [TJ Gamble][28]
@@ -90,12 +95,17 @@ We have channels for each project. These channels are recommended for new member
9095
- *Presentation* [Premium performance with PHP 7 and Varnish][15] by Miguel Balparda
9196

9297
[contribute]: https://github.com/magento/devdocs/blob/master/.github/CONTRIBUTING.md
98+
[technical guidelines]: https://devdocs.magento.com/guides/v2.3/coding-standards/technical-guidelines.html
99+
[coding standards]: https://devdocs.magento.com/guides/v2.3/coding-standards/bk-coding-standards.html
93100
[Magento Community Engineering Slack]: https://magentocommeng.slack.com
94101
[self signup]: https://tinyurl.com/engcom-slack
95102
[general]: https://magentocommeng.slack.com/messages/C4YS78WE6
96103
[github]: https://magentocommeng.slack.com/messages/C7KB93M32
97104
[public-backlog]: https://magentocommeng.slack.com/messages/CCV3J3RV5
98105
[devdocs]: https://magentocommeng.slack.com/messages/CAN932A3H
106+
[appdesign]: https://magentocommeng.slack.com/messages/CBSL1DF8B
107+
[coding-standards]: https://magentocommeng.slack.com/messages/CFC88F1C6
108+
[announcements]: https://magentocommeng.slack.com/messages/C7FA71S3V
99109
[0]: https://github.com/DavidLambauer/awesome-magento2
100110
[1]: https://github.com/magento/devdocs/blob/master/.github/CONTRIBUTING.md
101111
[2]: http://www.slideshare.net/StaceyWhitney1/mage-titans-usa-2016-joshua-warren-magento-2-integrations
@@ -152,3 +162,5 @@ We have channels for each project. These channels are recommended for new member
152162
[53]: https://bsscommerce.com/confluence/a-quick-guide-to-automation-test-in-magento-2/
153163
[54]: https://store.fooman.co.nz/blog
154164
[55]: https://alanstorm.com/
165+
[56]: https://markshust.com/
166+
[57]: https://www.youtube.com/watch?v=ceNeYpCEmys

‎guides/v2.0/coding-standards/technical-guidelines.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -513,6 +513,8 @@ class View extends Template
513513

514514
6.2.4. Actions MUST NOT reference blocks declared in layout.
515515

516+
6.2.5. Configuration for the presentation layer MUST be declared in the corresponding application area. This includes events and plugins that customize the presentation layer.
517+
516518
### 6.3. Data Access (Persistence) layer
517519

518520
6.3.1. Entities MAY have fields scoped differently (in product, EAV --- per store, options --- per website).

‎guides/v2.1/coding-standards/technical-guidelines.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -514,6 +514,8 @@ class View extends Template
514514

515515
6.2.4. Actions MUST NOT reference blocks declared in layout.
516516

517+
6.2.5. Configuration for the presentation layer MUST be declared in the corresponding application area. This includes events and plugins that customize the presentation layer.
518+
517519
### 6.3. Data Access (Persistence) layer
518520

519521
6.3.1. Entities MAY have fields scoped differently (in product, EAV --- per store, options --- per website).

‎guides/v2.1/extension-dev-guide/build/module-load-order.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ If you change the component load order using `<sequence>`, you must regenerate t
2323

2424
Assume you have a component that needs a configuration file from another component:
2525

26-
__Component A__ introduces `gadgetlayout.xml`, which updates block `gadgetBlock` from __component B__. In this case, layout files from __component A__ should be loaded before __component B__, so you should specify that in __component B's__ `<sequence>` entry in {% glossarytooltip c1e4242b-1f1a-44c3-9d72-1d5b1435e142 %}module{% endglossarytooltip %}.xml. In other words, __component B__ is dependent on __component A__. That is to say:
26+
__Component A__ introduces `gadgetlayout.xml`, which updates block `gadgetBlock` from __component B__. In this case, layout files from __component B__ should be loaded before __component A__, so you should specify that in __component A's__ `<sequence>` entry in {% glossarytooltip c1e4242b-1f1a-44c3-9d72-1d5b1435e142 %}module{% endglossarytooltip %}.xml. In other words, __component A__ is dependent on __component B__. That is to say:
2727

2828
{% highlight XML %}
2929
<?xml version="1.0"?>

‎guides/v2.2/coding-standards/technical-guidelines.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -506,6 +506,8 @@ class View extends Template
506506

507507
6.1.2. Every application layer (Presentation, Service Contracts, Data Access) MUST process (handle or re-throw) exceptions of the underlying layer.
508508

509+
6.2.5. Configuration for the presentation layer MUST be declared in the corresponding application area. This includes events and plugins that customize the presentation layer.
510+
509511
### 6.2. Presentation layer
510512

511513
6.2.1. According to CQRS, the Presentation layer hosts the Command and the Query Infrastructures:
@@ -604,6 +606,10 @@ class View extends Template
604606

605607
6.4.4.10. Service data interfaces MUST NOT contain any business logic. They SHOULD represent a container of data that is transferable over the wire. All the business logic SHOULD be moved to services.
606608

609+
6.4.4.11. Domain/business logic MUST be executed on the service contracts layer.
610+
611+
6.4.4.12. Any customizations to the domain/business logic MUST be executed on the Service Contracts layer, and so MUST be declared in the `global` area of configuration.
612+
607613
## 7. Configuration
608614

609615
7.1. An Application Instance consists of:

‎guides/v2.2/config-guide/varnish/use-varnish-cache.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,4 @@ You can then purge Varnish hosts when you refresh the Magento cache (also referr
5454

5555
To refresh the cache using the Admin, click **SYSTEM** > Tools > **Cache Management**, then click **Flush Magento Cache** at the top of the page. (You can also refresh individual cache types.)
5656

57-
To refresh the cache using the command line, you typically use the [`magento cache:clean <type>`]({{ page.baseurl }}/config-guide/cli/config-cli-subcommands-cache.html#config-cli-subcommands-cache-clean)</a> command as the [Magento file system owner]({{ page.baseurl }}/install-gde/prereq/file-sys-perms-over.html).
57+
To refresh the cache using the command line, you typically use the [`magento cache:clean <type>`]({{ page.baseurl }}/config-guide/cli/config-cli-subcommands-cache.html#config-cli-subcommands-cache-clean) command as the [Magento file system owner]({{ page.baseurl }}/install-gde/prereq/file-sys-perms-over.html).

0 commit comments

Comments
 (0)