Merge branch 'custom-layout-result-improvement' of https://github.com/chandru-199/devdocs into custom-layout-result-improvement

Author: chandru-199

src/_includes/graphql/customer-address-input.md

@@ -9,19 +9,15 @@ Attribute |  Data Type | Description
 `country_code` | String | The customer's country
 `country_id` | String | Deprecated. Use `country_code` instead. The customer's country
 `custom_attributes` | [CustomerAddressAttributeInput](#customerAddressAttributeInput) | Deprecated. Not applicable for GraphQL
-`customer_id` | Int | The customer ID
 `default_billing` | Boolean | Indicates whether the address is the default billing address
 `default_shipping` | Boolean | Indicates whether the address is the default shipping address
-`extension_attributes` | [CustomerAddressAttribute](#customerAddressAttributeInput) | Address extension attributes
 `fax` | String | The fax number
 `firstname` | String | The first name of the person associated with the shipping/billing address
-`id` | Int | The ID assigned to the address object
 `lastname` | String | The family name of the person associated with the shipping/billing address
 `middlename` | String | The middle name of the person associated with the shipping/billing address
 `postcode` | String | The customer's ZIP or postal code
 `prefix` | String | An honorific, such as Dr., Mr., or Mrs.
 `region` | [CustomerAddressRegionInput](#customerAddressRegionInput) | An object that defines the customer's state or province
-`region_id` | Int | Deprecated. Use `region` instead. A number that uniquely identifies the state, province, or other area
 `street` | [String] | An array of strings that define the street number and name
 `suffix` | String | A value such as Sr., Jr., or III
 `telephone` | String | The telephone number
@@ -44,4 +40,4 @@ Attribute |  Data Type | Description
 --- | --- | ---
 `region` | String | The state or province name
 `region_code` | String | The address region code
-`region_id` | Int | Deprecated. Use `region` instead. Uniquely identifies the region
+`region_id` | Int | Deprecated. Use `region` instead. Uniquely identifies the region

src/_includes/graphql/customer-address-output.md

@@ -11,7 +11,7 @@ Attribute |  Data Type | Description
 `country_code` | CountryCodeEnum | The customer's country
 `country_id` | String | Deprecated. Use `country_code` instead. The customer's country
 `custom_attributes` | [CustomerAddressAttribute](#customerAddressAttributeOutput) | Deprecated. Not applicable for GraphQL
-`customer_id` | Int | The customer ID
+`customer_id` | Int | Deprecated. This attribute is not applicable for GraphQL. The ID assigned to the customer
 `default_billing` | Boolean | Indicates whether the address is the default billing address
 `default_shipping` | Boolean | Indicates whether the address is the default shipping address
 `extension_attributes` | [CustomerAddressAttribute](#customerAddressAttributeOutput) | Address extension attributes
@@ -46,4 +46,4 @@ Attribute |  Data Type | Description
 --- | --- | ---
 `region` | String | The state or province name
 `region_code` | String | The address region code
-`region_id` | Int | Deprecated. Use `region` instead. Uniquely identifies the region
+`region_id` | Int | Deprecated. Use `region` instead. Uniquely identifies the region

src/cloud/before/before-workspace-magento-prereqs.md

@@ -172,48 +172,9 @@ To set `auto_increment_increment` to 3:
    service mysqld restart
    ```
 
-## Magento Cloud CLI (local) {#cloud-ssh-cli-cli-install}
+## Magento Cloud CLI {#cloud-ssh-cli-cli-install}
 
-The Magento Cloud command-line interface (CLI) tool helps you manage your projects and code branches on {{site.data.var.ece}}. For a list of available commands, see [Common Magento CLI commands]({{ site.baseurl }}/cloud/reference/cli-ref-topic.html).
-
-These instructions discuss installation using commands for a Unix environment. For Windows, we recommend using [Cygwin](https://www.cygwin.com/) or Git Bash.
-
-{:.procedure}
-To install the Magento Cloud CLI:
-
-1. Log in to your local development machine or switch to the [Magento file system owner]({{ site.baseurl }}/cloud/before/before-workspace-file-sys-owner.html).
-
-1. Change to a directory to which the [Magento file system owner](https://glossary.magento.com/magento-file-system-owner) has write access, such as the home directory.
-
-1. Enter the following command:
-
-   ```bash
-   curl -sS https://accounts.magento.cloud/cli/installer | php
-   ```
-
-1. After the CLI downloads, an operating system-specific command displays.
-
-   For example, on Ubuntu and CentOS, the command is similar to:
-
-   ```bash
-   source $HOME/.bashrc
-   ```
-
-   For more information about the user shell profile, see [.bash_profile vs .bashrc](https://apple.stackexchange.com/questions/51036/what-is-the-difference-between-bash-profile-and-bashrc)
-
-   You can also add the `$HOME/.magento-cloud/bin` to the Magento user's `PATH`:
-
-   ```bash
-   export PATH=$PATH:$HOME/.magento-cloud/bin
-   ```
-
-   Consult operating system documentation for details.
-
-1. Verify the `magento-cloud` command is in your path by entering the following command:
-
-   ```bash
-   magento-cloud list
-   ```
+To install the `magento-cloud` CLI , see the [Magento Cloud CLI reference]({{ site.baseurl }}/cloud/reference/cli-ref-topic.html).
 
 ## Additional requirements for Magento Commerce {#commerce}
 

src/cloud/env/environments-start.md

@@ -13,30 +13,9 @@ After you install the Magento Cloud CLI and set up SSH keys for remote access to
 
 To manage the branches and environments with the Project Web Interface, see [Manage branches with the Project Web Interface]({{ site.baseurl }}/cloud/project/project-webint-branch.html).
 
-## Common Magento Cloud CLI commands {#env-start-comm}
+## Use Magento Cloud CLI commands {#env-start-comm}
 
-Magento Cloud CLI commands are very similar to Git commands. You can use them to connect to your {{site.data.var.ece}} project and manage your  {{site.data.var.ece}} environments. Although you can run the commands from any directory, we recommend that you run them from a project directory. When run from a project directory, you can omit the `-p <project-ID>` parameter.
-
-The following list of commonly used Magento Cloud CLI commands includes required options only. Use the ``--help``
-option with any command to get more detailed information.
-
-Command | Description
---- | ---
-`git commit --allow-empty -m "redeploy" && git push <branch-name>` | Push an empty commit to force a redeployment. Some actions, such as adding a user, do not result in deployment.
-`magento-cloud login` | Log in to the project.
-`magento-cloud project:get <project-ID> <directory> -e <environment-ID>` | Clone a project to a directory. To clone the `master` environment, omit `-e <environment-ID>`.
-`magento-cloud environment:list -p <project-ID>` | List the environments in the current project.
-`magento-cloud environment:branch <name> <parent-branch>` | Create a new branch with a name and an ID. This information corresponds to the environment.
-`magento-cloud environment:checkout <environment-ID>` | Check out an existing environment.
-`magento-cloud environment:merge -p <project-ID> -e <environment ID>` | Merge changes in this environment with its parent.
-`magento-cloud environment:synchronize -p <project-ID> -e <environment-ID> {code|data}` | Synchronize (`git pull`) code and data from the parent to this environment.
-`magento-cloud variable:list` | List variables in this environment.
-`magento-cloud variable:set <name> <value>` | Set a value for an environment variable.
-
-For a full list of commands, see the [Magento Cloud CLI reference]({{ site.baseurl }}/cloud/reference/cli-ref-topic.html).
-
-{:.bs-callout-info}
-The environment _name_ is different from the environment _ID_ only if you use spaces or capital letters in the environment name. An environment ID consists of all lowercase letters, numbers, and allowed symbols. Capital letters in an environment name are converted to lowercase in the ID; spaces in an environment name are converted to dashes. An environment name _cannot_ include characters reserved for your Linux shell or for regular expressions. Forbidden characters include curly braces (`{ }`), parentheses, asterisk (`*`), angle brackets (`< >`), ampersand (`&`), percent (`%`), and other characters.
+Magento Cloud CLI commands are very similar to Git commands. You can use them to connect to your {{site.data.var.ece}} project and manage your {{site.data.var.ece}} environments. Although you can run the commands from any directory, we recommend that you run them from a project directory. When run from a project directory, you can omit the `-p <project-ID>` parameter. See the [Magento Cloud CLI reference]({{ site.baseurl }}/cloud/reference/cli-ref-topic.html).
 
 ## Get started creating branches {#getstarted}
 

src/cloud/project/project-conf-files_magento-app.md

@@ -20,8 +20,8 @@ Use the following properties to build your application configuration file. The `
 
 The name is used in the [`routes.yaml`]({{ site.baseurl }}/cloud/project/project-conf-files_routes.html) file to define the HTTP upstream (by default, `php:http`). For example, if the value of `name` is `app`, you must use `app:http` in the upstream field. You can also use this name in multi-application relationships.
 
-{:.bs-callout-info}
-Do not change the name of an application after it has been deployed.
+{:.bs-callout-warning}
+Do not change the name of an application after it has been deployed. Doing so will result in data loss.
 
 ### `type` and `build`
 

src/cloud/project/project-patch.md

@@ -36,7 +36,7 @@ To apply {{site.data.var.ece}} patches manually:
 1. From the project root, apply the patches.
 
    ```bash
-   php ./vendor/bin/ece-patches apply
+   php ./vendor/bin/ece-tools patch
    ```
 
 1. Clear the Magento cache.
@@ -83,10 +83,10 @@ To use magento-cloud-patches as a stand-alone package:
 1. From the project root, apply the patches.
 
    ```php
-   php ./vendor/bin/ece-patches apply
+   php ./vendor/bin/ece-tools patch
    ```
 
-   This command applies Magento patches and any custom patches found in the `m2/hotfixes` directory.
+   This command applies Magento patches and any custom patches found in the `/m2-hotfixes` directory.
 
 1. Clear the Magento cache.
 

src/cloud/reference/cli-ref-topic.md

@@ -5,30 +5,65 @@ functional_areas:
   - Cloud
 ---
 
-The Magento Cloud CLI is the utility for managing Magento Cloud projects and environments, which implements many features of the Project Web Interface and more. This utility provides an advanced management interface for developers, DevOps and system administrators, for doing routines and automation tasks. You can install and use this utility for all {{site.data.var.ece}} Starter and Pro Integration environments. You cannot use these commands for the Pro Staging and Production environments which aren't listed in the cloud UI.
+The Magento Cloud CLI is the utility for managing Magento Cloud projects and environments, which implements many features of the Project Web Interface and more. This utility provides an advanced management interface for developers and system administrators to perform routines and automation tasks. You can install and use this utility for all {{site.data.var.ece}} Starter and Pro Integration environments.
 
-You can install the Magento Cloud CLI when setting up your local environment for development:
+{:.procedure}
+To install the Magento Cloud CLI:
 
-*  [Install Magento prerequisites]({{ site.baseurl }}/cloud/before/before-workspace-magento-prereqs.html)
-*  [Enable SSH keys]({{ site.baseurl }}/cloud/before/before-workspace-ssh.html)
+1. On your local workstation, change to a directory where you plan to clone the cloud projects and where the [Magento file system owner](https://glossary.magento.com/magento-file-system-owner) has _write_ access.
 
-## Common commands
+1. Install the `magento-cloud` CLI.
 
-The following lists the available `magento-cloud` CLI commands:
+   ```bash
+   curl -sS https://accounts.magento.cloud/cli/installer | php
+   ```
 
-```bash
-magento-cloud list
-```
+1. Add `magento-cloud` CLI to the bash profile.
+
+   ```bash
+   export PATH=$PATH:$HOME/.magento-cloud/bin
+   ```
+
+   Consult operating system documentation for details.
+
+1. Reload the updated bash profile.
+
+   ```bash
+   . ~/.bash_profile
+   ```
+
+1. To initiate the CLI, call `magento-cloud` and enter your Cloud account credentials when prompted.
+
+   ```bash
+   magento-cloud
+   ```
+
+   ```terminal
+   Welcome to Magento Cloud!
+   Please log in using your Magento Cloud account.
+   Your email address or username:
+   ```
 
-{:.bs-callout-tip}
-You can also find information about `magento-cloud` CLI commands in the [Magento command-line tools reference](https://devdocs.magento.com/guides/v2.3/reference/cli/magento.html).
+1. Verify the `magento-cloud` command is in your path. The following example lists the available commands.
+
+   ```bash
+   magento-cloud list
+   ```
+
+## Common commands
 
 Magento designed these commands to manage Cloud Integration environments. It is a best practice to run the Magento Cloud CLI from a project directory, because you can omit the `-p <project ID>` parameter.
 
-Action | Command
------- | --------
-Log in to a project | `magento-cloud login`
-Clone a project to a directory | `magento-cloud project:get <PROJECT_ID> <DIRECTORY> -e <ENVIRONMENT_ID>`<br>**Note**: If you want to clone the `master` environment, omit the `-e <ENVIRONMENT_ID>` parameter.
+The following list of commonly used Magento Cloud CLI commands includes required options only. You can use the `--help` option with any command to see more information.
+
+Command | Description
+------- | -----------
+`magento-cloud login` | Log in to the project.
+`magento-cloud list` | List the environments in the current project.
+`magento-cloud environment:checkout <environment-ID>` | Check out an existing environment.
+`magento-cloud environment:merge -e <environment-ID>` | Merge changes in this environment with its parent.
+`magento-cloud variables` | List variables in this environment.
+`magento-cloud ssh` | Use SSH to connect to the remote environment.
 
 ## Environment commands
 
@@ -58,6 +93,11 @@ Trigger a redeployment without using a push. You must verify and confirm the env
 
 ```bash
 magento-cloud environment:redeploy
+```
+
+Sample response:
+
+```terminal
 Are you sure you want to redeploy the environment <environment_name>? [Y/n]
 ```
 
@@ -117,7 +157,7 @@ Help:
 
 ## Update Magento Cloud CLI
 
-The Magento Cloud CLI checks for available updates upon login, but you can also check for updates using the `self:update` command. If there is an update available, follow the instructions and enter `Y` for _yes_ to update the CLI.
+The Magento Cloud CLI checks for available updates when you log in, but you can check for updates using the `self:update` command. If there is an update available, follow the instructions to update the CLI.
 
 If your Magento Cloud CLI is up to date, you see the following response:
 

src/common/images/ui_comps/ui-columns-editor-record-custom-field-types-result.png

@@ -174,7 +174,6 @@ Product Listing Sort by | `catalog/frontend/default_sort_by` | <!-- ![Not EE-onl
 Allow All Products per Page | `catalog/frontend/list_allow_all` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
 Use Flat Catalog Category | `catalog/frontend/flat_catalog_category` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
 Use Flat Catalog Product | `catalog/frontend/flat_catalog_product` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
-Allow Dynamic Media URLs in Products and Categories | `catalog/frontend/parse_url_directives` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
 Swatches per Product | `catalog/frontend/swatches_per_product` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
 Allow Guests to Write Reviews | `catalog/review/allow_guest` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |
 Allow Alert When Product Price Changes | `catalog/productalert/allow_price` | <!-- ![Not EE-only]({{ site.baseurl }}/common/images/red-x.png) --> |

src/guides/v2.3/config-guide/prod/config-reference-most.md

@@ -328,3 +328,7 @@ Now that the module is code-complete, run the following commands to install it:
 Once the module installation has completed, the link to the **Hello World** page should appear in the **Greetings** section under **Content** in the left navigation in the admin area. Clicking this link will take you to a page that looks like the one pictured below.
 
 ![Hello World Page]({{ site.baseurl }}/common/images/ext-best-practices/hello-world-page.png)
+
+## Related topics
+
+*  [Create an ACL rule]({{ page.baseurl }}/ext-best-practices/tutorials/create-access-control-list-rule.html)