Merge branch 'develop' into MAGEDOC-4042-preRelease-install

Author: jeff-matthews

.github/ISSUE_TEMPLATE/COMMUNITY_ISSUE_TEMPLATE.md

@@ -37,7 +37,6 @@ Notifications of Changes:
 
 <!-- (OPTIONAL) What other information can you provide? -->
 
-
 <!--
 Thank you for taking the time to request updates for your Community Engineering contribution!
 GitHub Issues should only be created for problems/topics related to this project's codebase.

.github/PULL_REQUEST_TEMPLATE.md

@@ -22,7 +22,7 @@ This pull request (PR) ...
 
 - ...
 
-<!-- 
+<!--
 If you are fixing a GitHub issue, note it using GitHub keyword format (https://help.github.com/en/articles/closing-issues-using-keywords#closing-an-issue-in-a-different-repository) to close the issue when this pull request is merged. Example: `Fixes #1234`
 
 `master` is the default branch. Merged pull requests to `master` go live on the site automatically. Any requested changes to content on the `master` branch must be related to the released codebase. Any content related to future releases goes in the `develop` branch.

404.md

@@ -12,8 +12,6 @@ permalink: /404.html
 
 The page you are looking for could not be found or the documentation does not exist.
 
-
 To report a missing page, please submit an issue in our public [GitHub](https://github.com/magento/devdocs) repo.
 
-
 [Return to main page]({{ site.baseurl }}/)

README.md

@@ -8,7 +8,7 @@ Our goal is to provide the Magento community with comprehensive and quality tech
 
 ![](https://raw.githubusercontent.com/wiki/magento/magento2/images/dev_docs_contributors.png)
 
-# Building this site
+## Building this site
 
 You can build this site locally in the following ways:
 
@@ -225,7 +225,7 @@ If you have questions, open an issue and ask us. We're looking forward to hearin
 
 ## Build DevDocs in Windows
 
-Some of the technologies we use to develop DevDocs is not compatible with Windows, such as [Jekyll](https://jekyllrb.com/docs/windows/). For this reason, we do not support DevDocs management in Windows; however, we have documented the following procedures to build the DevDocs in a Windows environment. Any further use of this setup or troubleshooting is up to you. 
+Some of the technologies we use to develop DevDocs is not compatible with Windows, such as [Jekyll](https://jekyllrb.com/docs/windows/). For this reason, we do not support DevDocs management in Windows; however, we have documented the following procedures to build the DevDocs in a Windows environment. Any further use of this setup or troubleshooting is up to you.
 
 Download software:
 
@@ -248,7 +248,7 @@ Only Administrators can use Chocolatey features. You can use the Administrator a
 
     -  In the Windows UI, open search and type `path`.
     -  In the Windows CMD console, type `echo %path%`.
-    
+
     You should see `C:\ProgramData\chocolatey\bin` in the path.
 
 1.  Close and reopen the command prompt before using `choco` commands.
@@ -272,7 +272,7 @@ If you have Ruby installed on the workstation, then you can skip this installati
     -  In the Windows UI, open search and type `path`.
     -  In the Windows CMD console, type `echo %path%`.
 
->  **NOTE**  
+>  **NOTE**
 >  If you encounter problems with Ruby, or the `gem` command is not recognized, you can install the `rubyinstaller-devkit.exe` development kit located in the `c:\ProgramData\chocolatey\bin` folder.
 
 ### Install Git for Windows
@@ -300,7 +300,6 @@ Although you can install Git using Chocolatey, we chose to install _Git for Wind
 
 1.  Follow the [Generating a new SSH](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/) instructions.
 
-
 ### Clone and build the DevDocs repository
 
 You may have to close and reopen the Git Bash application after the Choco installations.
@@ -345,5 +344,5 @@ You may have to close and reopen the Git Bash application after the Choco instal
       Server running... press ctrl-c to stop.
     ```
 
->  **NOTE**  
+>  **NOTE**
 >  The `.bash_profile` file CAN be created and managed using Git Bash, which is useful for aliases and other customizations, This file is in the `users/Administrator` folder.

_checks/styles/style-rules-prod

@@ -1,24 +1,24 @@
 exclude_rule 'MD001'
 exclude_rule 'MD002'
-exclude_rule 'MD003'
+rule 'MD003', :style => :atx
 exclude_rule 'MD004'
 exclude_rule 'MD005'
 exclude_rule 'MD006'
 exclude_rule 'MD007'
-exclude_rule 'MD009'
+rule 'MD009'
 exclude_rule 'MD010'
 exclude_rule 'MD011'
-exclude_rule 'MD012'
+rule 'MD012'
 exclude_rule 'MD013'
 exclude_rule 'MD014'
 exclude_rule 'MD018'
-exclude_rule 'MD019'
+rule 'MD019'
 exclude_rule 'MD020'
 exclude_rule 'MD021'
 exclude_rule 'MD022'
 exclude_rule 'MD023'
 exclude_rule 'MD024'
-exclude_rule 'MD025'
+rule 'MD025'
 exclude_rule 'MD026'
 exclude_rule 'MD027'
 exclude_rule 'MD028'
@@ -28,10 +28,10 @@ exclude_rule 'MD031'
 exclude_rule 'MD032'
 exclude_rule 'MD033'
 exclude_rule 'MD034'
-exclude_rule 'MD035'
+rule 'MD035'
 exclude_rule 'MD036'
-exclude_rule 'MD037'
-exclude_rule 'MD038'
+rule 'MD037'
+rule 'MD038'
 exclude_rule 'MD039'
 exclude_rule 'MD040'
 exclude_rule 'MD041'

_config.checks.yml

@@ -28,7 +28,6 @@ html-proofer:
 
   # Ignore entirely the files which pathname matches a specified pattern 
   :file_ignore:
-    - !ruby/regexp /page-builder/
     - !ruby/regexp /guides\/v2\.3\/mrg/
 
   :internal_domains:

_data/toc/cloud-guide.yml

@@ -23,12 +23,6 @@ pages:
         - label: Pro develop and deploy workflow
           url: /cloud/architecture/pro-develop-deploy-workflow.html
 
-        - label: Pro architecture (legacy)
-          url: /cloud/architecture/pro-architecture-legacy.html
-
-        - label: Add Staging and Production to Pro projects UI
-          url: /cloud/trouble/pro-env-management.html
-
     - label: Technologies and requirements
       url: /cloud/requirements/cloud-requirements.html
       children:

_data/toc/graphql.yml

@@ -47,6 +47,12 @@ pages:
 
     - label: Queries
       children:
+        - label: category query
+          url: /graphql/queries/category.html
+
+        - label: checkoutAgreements query
+          url: /graphql/queries/checkout-agreements.html
+
         - label: cmsBlock query
           url: /graphql/queries/cms-block.html
 
@@ -62,15 +68,33 @@ pages:
         - label: currency query
           url: /graphql/queries/directory-currency.html
 
+        - label: customAttributeMetadata query
+          url: /graphql/queries/custom-attribute-metadata.html
+
+        - label: customer query
+          url: /graphql/queries/customer.html
+
         - label: customerOrders query
           url: /graphql/queries/customer-orders.html
 
+        - label: customerDownloadableProducts query
+          url: /graphql/queries/customer-downloadable-products.html
+
         - label: customerPaymentTokens query
           url: /graphql/queries/customer-payment-tokens.html
 
         - label: getHostedProUrl query
           url: /graphql/queries/get-hosted-pro-url.html
 
+        - label: getPayflowLinkToken query
+          url: /graphql/queries/get-payflow-link-token.html
+
+        - label: isEmailAvailable query
+          url: /graphql/queries/is-email-available.html
+
+        - label: products query
+          url: /graphql/queries/products.html
+
         - label: storeConfig query
           url: /graphql/queries/store-config.html
 
@@ -82,59 +106,79 @@ pages:
 
     - label: Mutations
       children:
+        - label: addConfigurableProductsToCart mutation
+          url: /graphql/mutations/add-configurable-products.html
+
         - label: applyStoreCreditToCart mutation
           url: /graphql/mutations/apply-store-credit.html
 
+        - label: changeCustomerPassword mutation
+          url: /graphql/mutations/change-customer-password.html
+
+        - label: createCustomerAddress mutation
+          url: /graphql/mutations/create-customer-address.html
+
+        - label: createCustomer mutation
+          url: /graphql/mutations/create-customer.html
+
+        - label: createPayflowProToken mutation
+          url: /graphql/mutations/create-payflow-pro-token.html
+
+        - label: deleteCustomerAddress mutation
+          url: /graphql/mutations/delete-customer-address.html
+
         - label: deletePaymentToken mutation
           url: /graphql/mutations/delete-payment-token.html
 
-        - label: removeStoreCreditFromCart mutation
-          url: /graphql/mutations/remove-store-credit.html
-    
-    - label: Reference
-      children:
-            - label: CustomAttributeMetadata endpoint
-              url: /graphql/reference/custom-attribute-metadata.html
+        - label: generateCustomerToken mutation
+          url: /graphql/mutations/generate-customer-token.html
+
+        - label: handlePayflowProResponse mutation
+          url: /graphql/mutations/handle-payflow-pro-response.html
 
-            - label: Customer endpoint
-              url: /graphql/reference/customer.html
+        - label: redeemGiftCardBalanceAsStoreCredit mutation
+          url: /graphql/mutations/redeem-giftcard-balance.html
 
-            - label: Payflow Link getPayflowLinkToken query
-              url: /graphql/reference/paypal-get-payflow-link-token.html
+        - label: removeGiftCardFromCart mutation
+          url: /graphql/mutations/remove-giftcard.html
 
-            - label: Payflow Pro createPayflowProToken mutation
-              url: /graphql/reference/paypal-create-payflow-pro-token.html
+        - label: removeStoreCreditFromCart mutation
+          url: /graphql/mutations/remove-store-credit.html
 
-            - label: Payflow Pro handlePayflowProResponse mutation
-              url: /graphql/reference/paypal-handle-payflow-pro-response.html
+        - label: revokeCustomerToken mutation
+          url: /graphql/mutations/revoke-customer-token.html
 
-            - label: Products endpoint
-              url: /graphql/reference/products.html
-              children:
-                - label: Product interface implementations
-                  url: /graphql/reference/product-interface-implementations.html
+        - label: updateCustomerAddress mutation
+          url: /graphql/mutations/update-customer-address.html
 
-                - label: CustomizableOptionInterface
-                  url: /graphql/reference/customizable-option-interface.html
+        - label: updateCustomer mutation
+          url: /graphql/mutations/update-customer.html
 
-                - label: BundleProduct endpoint
-                  url: /graphql/reference/bundle-product.html
+    - label: Product data types and interfaces
+      children:
+        - label: Product interface implementations
+          url: /graphql/product/product-interface-implementations.html
 
-                - label: Category endpoint
-                  url: /graphql/reference/categories.html
+        - label: CustomizableOptionInterface
+          url: /graphql/product/customizable-option-interface.html
 
-                - label: ConfigurableProduct endpoint
-                  url: /graphql/reference/configurable-product.html
+        - label: Bundle product data types
+          url: /graphql/product/bundle-product.html
 
-                - label: DownloadableProduct endpoint
-                  url: /graphql/reference/downloadable-product.html
+        - label: Configurable product data types
+          url: /graphql/product/configurable-product.html
 
-                - label: GiftCardProduct endpoint
-                  url: /graphql/reference/gift-card-product.html
+        - label: Downloadable product data types
+          url: /graphql/product/downloadable-product.html
 
-                - label: GroupedProduct endpoint
-                  url: /graphql/reference/grouped-product.html
+        - label: GiftCardProduct data types
+          url: /graphql/product/gift-card-product.html
 
+        - label: GroupedProduct data types
+          url: /graphql/product/grouped-product.html
+
+    - label: Reference
+      children:
             - label: Quote endpoint (cart query)
               url: /graphql/reference/quote.html
               children:
@@ -163,9 +207,6 @@ pages:
                 - label: removeCouponFromCart mutation
                   url: /graphql/reference/quote-remove-coupon.html
 
-                - label: removeGiftCardFromCart mutation
-                  url: /graphql/reference/quote-remove-giftcard.html
-
                 - label: removeItemFromCart mutation
                   url: /graphql/reference/quote-remove-item.html
 
@@ -190,15 +231,18 @@ pages:
                 - label: updateCartItems mutation
                   url: /graphql/reference/quote-update-cart-items.html
 
-            - label: redeemGiftCardBalanceAsStoreCredit mutation
-              url: /graphql/reference/redeem-giftcard-balance.html
-
     - label: Payment methods
       children:
 
         - label: Authorize.Net
           url: /graphql/payment-methods/authorize-net.html
 
+        - label: Braintree
+          url: /graphql/payment-methods/braintree.html
+
+        - label: Braintree Vault
+          url: /graphql/payment-methods/braintree-vault.html
+
         - label: PayPal Express Checkout
           url: /graphql/payment-methods/paypal-express-checkout.html
 

_data/toc/javascript-developer-guide.yml

@@ -46,6 +46,9 @@ pages:
         - label: Alert widget
           url: /javascript-dev-guide/widgets/widget_alert.html
 
+        - label: Breadcrumbs widget
+          url: /javascript-dev-guide/widgets/widget-breadcrumbs.html
+
         - label: Calendar widget
           url: /javascript-dev-guide/widgets/widget_calendar.html
 
@@ -79,6 +82,9 @@ pages:
         - label: Modal widget
           url: /javascript-dev-guide/widgets/widget_modal.html
 
+        - label: Multiselect widget
+          url: /javascript-dev-guide/widgets/widget-multiselect.html
+
         - label: Navigation widget
           url: /javascript-dev-guide/widgets/widget_navigation.html
 
@@ -97,6 +103,9 @@ pages:
         - label: RedirectUrl widget
           url: /javascript-dev-guide/widgets/widget_redirectUrl.html
 
+        - label: RowBuilder widget
+          url: /javascript-dev-guide/widgets/widget-row-builder.html
+
         - label: Tabs widget
           url: /javascript-dev-guide/widgets/widget_tabs.html
 

_data/toc/php-developer-guide.yml

@@ -256,6 +256,10 @@ pages:
         - label: Adapters
           url: /extension-dev-guide/adapters.html
 
+        - label: View models
+          include_versions: ["2.2", "2.3"]
+          url: /extension-dev-guide/view-models.html
+
         - label: Variable Pool
           include_versions: ["2.3"]
           url: /extension-dev-guide/variable-pool/

_data/toc/rest-api.yml

@@ -111,6 +111,10 @@ pages:
         url: /rest/tutorials/bulk-configurable-product/config-product-intro.html
         include_versions: ["2.3"]
 
+      - label: Create and manage grouped products
+        class: tutorial
+        url: /rest/tutorials/grouped-product/create-and-manage-grouped-products.html
+
     - label: Modules
       children: