Merge branch 'master' of github.com:magento-commerce/devdocs into AC-1537_update-devdocs

Author: loginesta

src/_data/toc/cloud-guide.yml

@@ -570,46 +570,14 @@ pages:
       versionless: true
       children:
 
-        - label: Troubleshoot deployment
-          url: /cloud/trouble/troubleshoot-deployment.html
-          versionless: true
-
-        - label: Incorrect credentials
-          url: /cloud/trouble/trouble_ce-creds.html
-          versionless: true
-
-        - label: Resolve issues with a new project
-          url: /cloud/trouble/trouble_proj-startover.html
-          versionless: true
-
         - label: Component deployment failure
           url: /cloud/trouble/trouble_comp-deploy-fail.html
           versionless: true
 
-        - label: Resolve issues with encryption key
-          url: /cloud/trouble/trouble-crypt-key-variable.html
-          versionless: true
-
-        - label: Resolve issues with HTML minification
-          url: /cloud/trouble/trouble-error-html-minification.html
-          versionless: true
-
-        - label: Resolve issues with Google Analytics during deployment
-          url: /cloud/trouble/trouble-google-analytics-deploy.html
-          versionless: true
-
-        - label: Site availability
-          url: /cloud/trouble/site-availability.html
-          versionless: true
-
         - label: Add site map and search engine robots
           url: /cloud/trouble/robots-sitemap.html
           versionless: true
 
-        - label: Theme troubleshooting
-          url: /cloud/trouble/theme-troubleshooting.html
-          versionless: true
-
     - label: Upgrades and patches
       url: /cloud/project/project-upgrade-parent.html
       versionless: true

src/_data/toc/product-recommendations.yml

@@ -12,7 +12,7 @@ pages:
   url: /recommendations/install-configure.html
   versionless: true
 
-- label: Recommendation Events
+- label: Data Collection for Recommendations
   url: /recommendations/events.html
   versionless: true
 

src/_data/var.yml

@@ -21,24 +21,23 @@ mbi: Adobe Commerce Reporting
 # Cloud product name variables
 
 ece: Adobe Commerce on cloud infrastructure
-ece-release-date: July 29, 2021
 csuite: Cloud Suite for Commerce
 
 ct: ece-tools
 ct-repo: magento/ece-tools
-ct-release: 2002.1.7
+ct-release: 2002.1.8
 
 mcc-prod: Cloud Components of Commerce
 mcc-package: magento/magento-cloud-components
-mcc-release: 1.0.8
+mcc-release: 1.0.9
 
 mcd-prod: Cloud Docker for Commerce
 mcd-package: magento/magento-cloud-docker
-mcd-release: 1.2.4
+mcd-release: 1.3.0
 
 mcp-prod: Cloud Patches for Commerce
 mcp-package: magento/magento-cloud-patches
-mcp-release: 1.0.12
+mcp-release: 1.0.13
 
 # TIP: Use the following syntax to use a variable in the documentation source: {{site.data.var.xx}} where xx
 # is the variable value.

src/_data/whats-new.yml

@@ -4,8 +4,73 @@ description: This page contains recent changes that we think you'd like to know
   We exclude from this list proofreading, spelling checks, and all minor updates.
 link: "/whats-new.html"
 thread: "/whatsnew-feed.xml"
-updated: Mon Oct 18 14:38:48 2021
+updated: Mon Oct 25 15:15:23 2021
 entries:
+- description: Added the "cache" and "system"  descriptions to the [env.php reference](https://devdocs.magento.com/guides/v2.4/config-guide/prod/config-reference-envphp.html)
+    topic.
+  versions: 2.4.x
+  type: Major Update
+  date: October 22, 2021
+  link: https://github.com/magento/devdocs/pull/9186
+  merge_commit: ecfce43befaea1054d0ed8451a208ea07de3d2b4
+  contributor: srsathish92
+  membership: false
+  labels:
+  - Major Update
+  - partners-contribution
+  - 2.4.x
+  - 'Progress: done'
+  - 'Partner: ITG Commerce'
+- description: "[Release notes](https://devdocs.magento.com/live-search/release-notes.html)
+    for Live Search 1.3.0"
+  versions: 2.4.x
+  type: Major Update
+  date: October 21, 2021
+  link: https://github.com/magento-commerce/devdocs/pull/2592
+  merge_commit: ecd524f562b0f03de9b65c06d849415617e53dd6
+  contributor: ccondra
+  membership: true
+  labels:
+  - Major Update
+  - 2.4.x
+- description: The Composer `root-update-plugin` has been updated to be compatible
+    with Composer 2.1.6. [Upgrade Commerce](https://devdocs.magento.com/guides/v2.4/comp-mgr/cli/cli-upgrade.html)
+    provides details about upgrading Magento Open Source and Adobe Commerce with the
+    new version of the plugin.
+  versions: 2.4.4
+  type: Major Update
+  date: October 20, 2021
+  link: https://github.com/magento-commerce/devdocs/pull/2581
+  merge_commit: 5a9604f08dac24aaf84ecf423486d460798df5dd
+  contributor: keharper
+  membership: true
+  labels:
+  - Major Update
+  - 2.4.4
+- description: Update [reference data for the backward incompatible changes](https://devdocs.magento.com/guides/v2.4/release-notes/backward-incompatible-changes/reference.html).
+    Covering entire products instead of the main source code repositories.
+  versions: 2.4.x
+  type: Major Update
+  date: October 20, 2021
+  link: https://github.com/magento-commerce/devdocs/pull/2598
+  merge_commit: 7c08bc0fb8369b1c524dca7abd027eb837aeb3a0
+  contributor: dshevtsov
+  membership: true
+  labels:
+  - Major Update
+  - 2.4.x
+- description: Added a [public roadmap](https://devdocs.magento.com/release/roadmap.html)
+    for Magento Open Source.
+  versions: 2.x
+  type: New Topic
+  date: October 20, 2021
+  link: https://github.com/magento-commerce/devdocs/pull/2603
+  merge_commit: 5a0d39d531a142d92d97a6b0e7cec249aa03757e
+  contributor: jeff-matthews
+  membership: true
+  labels:
+  - 2.x
+  - New Topic
 - description: Reference data for the [2.4.3-p1](https://devdocs.magento.com/guides/v2.4/release-notes/backward-incompatible-changes/reference.html),
     [2.3.7-p1 and 2.3.7-p2](https://devdocs.magento.com/guides/v2.3/release-notes/backward-incompatible-changes/reference.html)
     backward incompatible changes.

src/_includes/cloud/backup-db.md

@@ -25,7 +25,7 @@ To back up your Staging or Production environment database before deploying:
 
 1. Use SSH to log in to the remote server.
 
-1. Create a database dump.
+1. Create a database dump. To choose a target directory for the DB dump, use the `--dump-directory` option.
 
    ```bash
    vendor/bin/ece-tools db-dump

src/cloud/docker/docker-development.md

@@ -115,7 +115,7 @@ Prior to setting up a local workspace, gather the following credentials and acco
 [authentication keys]: {{site.baseurl}}/guides/v2.3/install-gde/prereq/connect-auth.html
 [Magento Cloud template]: https://github.com/magento/magento-cloud
 [Set up an account]: {{site.baseurl}}/cloud/before/before-workspace.html#newaccount
-[Resolve issues with encryption key]: {{site.baseurl}}/cloud/trouble/trouble-crypt-key-variable.html
+[Resolve issues with encryption key]: https://support.magento.com/hc/en-us/articles/360033978652
 [Update the hosts file and install dependencies]: {{site.baseurl}}/cloud/docker/docker-installation.html#update-the-hosts-file-and-install-dependencies
 [{{site.data.var.mcd-package}} GitHub repository]: https://github.com/magento/magento-cloud-docker
 [Get support for {{site.data.var.mcd-prod}}]: {{site.baseurl}}/cloud/docker/docker-troubleshooting.html

src/cloud/docker/docker-mode-developer.md

@@ -11,7 +11,7 @@ Developer mode supports an active development environment with full, writable fi
 
 ## Performance considerations
 
-On macOS and Windows systems, performance is slower in developer mode because of additional file synchronization operations. However, you can improve performance by using either the `manual-native` or the `mutagen` file synchronization option when you generate the `docker-compose.yml` file. See [Synchronizing data in Docker].
+On macOS and Windows systems, performance is slower in developer mode because of additional file synchronization operations. However, you can improve performance by using either the `manual-native` or the `mutagen` file synchronization option when you generate the `docker-compose.yml` file. See [Synchronizing data in Docker][sync].
 
 {: .bs-callout-info }
 The `{{site.data.var.ct}}` version 2002.0.18 and later supports developer mode.
@@ -24,7 +24,7 @@ Large files (>1 GB) can cause a period of inactivity. DB dumps and archive files
 **Prerequisites:**
 
 -  Complete the [installation steps].
--  [Install file synchronization tools][Synchronizing data in Docker] if needed.
+-  [Install file synchronization tools][sync] if needed.
 
 {:.procedure}
 To launch the Docker environment in developer mode:
@@ -35,7 +35,10 @@ To launch the Docker environment in developer mode:
    ./vendor/bin/ece-docker build:compose --mode="developer"
    ```
 
-   If required, set the option for [synchronizing data in Docker]. For example:
+   {:.bs-callout-info}
+   The `--mode` option in this step determines the mode in a later `deploy` step.
+
+   If required, set the option for [synchronizing data in Docker][sync]. For example:
 
    ```bash
    ./vendor/bin/ece-docker build:compose --mode="developer" --sync-engine="mutagen"
@@ -107,10 +110,6 @@ To launch the Docker environment in developer mode:
       docker-compose run --rm deploy cloud-deploy
       ```
 
-      ```bash
-      docker-compose run --rm deploy magento-command deploy:mode:set developer
-      ```
-
    -  Run post-deploy hooks.
 
        ```bash
@@ -153,12 +152,10 @@ To launch the Docker environment in developer mode:
 
 <!--Link definitions-->
 
-[{{site.data.var.mcd-prod}} Docker image]: https://hub.docker.com/r/magento/magento-cloud-docker-php/tags
 [installation steps]: {{site.baseurl}}/cloud/docker/docker-installation.html
-[latest release of the {{site.data.var.mcd-package}}]: https://github.com/magento/magento-cloud-docker/releases
 [magento-creds]: {{site.baseurl}}/cloud/setup/first-time-setup-import-prepare.html#auth-json
 [mutagen-install]: https://mutagen.io/documentation/introduction/installation/
 [services]: {{site.baseurl}}/cloud/docker/docker-containers.html#service-containers
 [service configuration options]: {{site.baseurl}}/cloud/docker/docker-containers.html#service-configuration-options
-[Synchronizing data in Docker]: {{site.baseurl}}/cloud/docker/docker-syncing-data.html
+[sync]: {{site.baseurl}}/cloud/docker/docker-syncing-data.html
 [xdebug]: {{site.baseurl}}/cloud/docker/docker-development-debug.html#configure-xdebug]

src/cloud/howtos/install-components.md

@@ -74,7 +74,7 @@ To install an extension:
    Module is enabled
    ```
 
-   If you encounter deployment errors, see [extension deployment failure][trouble].
+   If you encounter deployment errors, see [extension deployment failure][].
 
 ## Manage extensions
 
@@ -168,4 +168,4 @@ If you encounter errors, see [extension deployment failure][].
 [config]: {{ site.baseurl }}/guides/v2.3/config-guide/config/config-php.html
 [extensions]: {{ site.baseurl }}/extensions/
 [Commerce Marketplace]: https://marketplace.magento.com
-[trouble]: {{ site.baseurl }}/cloud/trouble/trouble_comp-deploy-fail.html
+[extension deployment failure]: {{ site.baseurl }}/cloud/trouble/trouble_comp-deploy-fail.html

src/cloud/live/live-sanity-check.md

@@ -27,7 +27,7 @@ If you modified your `composer.json` file to add modules, we recommend running t
 
 Your Git branch must have the following files for building and deploying to your local, Integration, Staging, and Production environments:
 
-*  `auth.json` in the root project directory. This file includes the authentication keys entered when creating the project. If you need to verify the file and settings, see [Troubleshoot deployment]({{ site.baseurl }}/cloud/trouble/troubleshoot-deployment.html).
+*  `auth.json` in the root project directory. This file includes the authentication keys entered when creating the project. If you need to verify the file and settings, see [Troubleshoot deployment](https://support.magento.com/hc/en-us/articles/4411647469965).
 *  `config.php` if you use [Configuration Management]({{ site.baseurl }}/cloud/live/sens-data-over.html) to manage configuration settings
 *  [`.magento.app.yaml`]({{ site.baseurl }}/cloud/project/magento-app.html) is updated and saved in the root directory
 *  [`services.yaml`]({{ site.baseurl }}/cloud/project/services.html) is updated and saved in `magento/`