From 61e5a2ecd836467f8d58bd4738b0f7b9e51b0a65 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Tue, 26 Oct 2021 16:56:51 +0800
Subject: [PATCH 1/7] Add instruction for installing specific version

---
 .../includes/cli-install-linux-apt.md         | 18 ++++++++++++++----
 .../includes/cli-install-linux-dnf.md         | 19 +++++++++++++++----
 .../includes/cli-install-linux-zypper.md      | 18 +++++++++++++++---
 .../includes/interactive-login.md             |  6 ++++++
 .../install-azure-cli-macos.md                | 11 ++++++++---
 .../install-azure-cli-windows.md              |  8 +++++++-
 docs-ref-conceptual/run-azure-cli-docker.md   | 10 +++++++---
 7 files changed, 72 insertions(+), 18 deletions(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-apt.md b/docs-ref-conceptual/includes/cli-install-linux-apt.md
index c6ae39674a..997463cc4b 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-apt.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-apt.md
@@ -69,13 +69,23 @@ If you prefer a step-by-step installation process, complete the following steps
     sudo apt-get install azure-cli
     ```
 
-## Sign in to Azure with the Azure CLI
+## Install specific version
 
-Run the Azure CLI with the `az` command. To sign in, use the [az login](/cli/azure/reference-index#az_login) command.
+You must first configure `azure-cli` repository information as shown above.
 
-[!INCLUDE [interactive-login](interactive-login.md)]
+To view available versions:
+
+```bash
+apt-cache policy azure-cli
+```
+
+To install specific version:
 
-To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
+```bash
+sudo apt-get install azure-cli=2.29.1-1~bullseye
+```
+
+[!INCLUDE [interactive-login](interactive-login.md)]
 
 ## Troubleshooting
 
diff --git a/docs-ref-conceptual/includes/cli-install-linux-dnf.md b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
index cfea6fb4eb..712a95b6f7 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-dnf.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
@@ -44,13 +44,24 @@ for the Azure CLI. This package has been tested with RHEL 7.7, RHEL 8, Fedora 24
    ```bash
    sudo dnf install azure-cli
    ```
- 
-Run the Azure CLI with the `az` command. To sign in, use [az login](/cli/azure/reference-index#az_login) command.
 
+## Install specific version
 
-[!INCLUDE [interactive-login](interactive-login.md)]
+You must first configure `azure-cli` repository information as shown above.
+
+To view available versions:
+
+```bash
+dnf --showduplicates list azure-cli
+```
 
-To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
+To install specific version:
+
+```bash
+sudo dnf install azure-cli-2.29.1-1.el7
+```
+
+[!INCLUDE [interactive-login](interactive-login.md)]
 
 ## Troubleshooting
 
diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index e1224257b2..a7d75dfc98 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -46,11 +46,23 @@ for the Azure CLI. This package has been tested with openSUSE Leap 15.1, and SLE
 
    Input 2 to continue install by ignoring some of its dependencies.
 
-You can then run the Azure CLI with the `az` command. To sign in, use [az login](/cli/azure/reference-index#az_login) command.
+## Install specific version
 
-[!INCLUDE [interactive-login](interactive-login.md)]
+You must first configure `azure-cli` repository information first as shown above.
+
+To view available versions:
+
+```bash
+zypper search --details --match-exact azure-cli
+```
 
-To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
+To install specific version:
+
+```bash
+sudo zypper install --from azure-cli azure-cli=2.29.1-1.el7
+```
+
+[!INCLUDE [interactive-login](interactive-login.md)]
 
 ## Troubleshooting
 
diff --git a/docs-ref-conceptual/includes/interactive-login.md b/docs-ref-conceptual/includes/interactive-login.md
index d4f072b0da..660ccd4e6f 100644
--- a/docs-ref-conceptual/includes/interactive-login.md
+++ b/docs-ref-conceptual/includes/interactive-login.md
@@ -5,6 +5,10 @@ manager: carmonm
 ms.date: 09/07/2018
 ms.topic: include
 ---
+## Sign in to Azure with the Azure CLI
+
+You can then run the Azure CLI with the `az` command. To sign in, use [`az login`](/cli/azure/reference-index#az_login) command.
+
 1. Run the `login` command.
 
     ```azurecli-interactive
@@ -19,3 +23,5 @@ ms.topic: include
     If no web browser is available or the web browser fails to open, use device code flow with **az login --use-device-code**.
 
 2. Sign in with your account credentials in the browser.
+
+To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
diff --git a/docs-ref-conceptual/install-azure-cli-macos.md b/docs-ref-conceptual/install-azure-cli-macos.md
index da571000a8..fc758184b8 100644
--- a/docs-ref-conceptual/install-azure-cli-macos.md
+++ b/docs-ref-conceptual/install-azure-cli-macos.md
@@ -38,11 +38,16 @@ brew update && brew install azure-cli
 > The Azure CLI is guaranteed to be compatible with the latest version of `python3`
 > published on Homebrew.
 
-You can then run the Azure CLI with the `az` command. To sign in, use [az login](/cli/azure/reference-index#az_login) command.
+## Install specific version
 
-[!INCLUDE [interactive-login](includes/interactive-login.md)]
+To install specific version:
 
-To learn more about different authentication methods, see [Sign in with Azure CLI](authenticate-azure-cli.md).
+```bash
+curl -L https://raw.githubusercontent.com/azclibot/homebrew-core/azcli2.29.1/Formula/azure-cli.rb > azure-cli.rb
+brew install --build-from-source azure-cli.rb
+```
+
+[!INCLUDE [interactive-login](includes/interactive-login.md)]
 
 ## Troubleshooting
 
diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md
index 4d13827fd6..b94e0d2f40 100644
--- a/docs-ref-conceptual/install-azure-cli-windows.md
+++ b/docs-ref-conceptual/install-azure-cli-windows.md
@@ -31,13 +31,17 @@ The MSI distributable is used for installing or updating the Azure CLI on Window
 
 When the installer asks if it can make changes to your computer, click the "Yes" box.
 
-### Azure CLI current version
+### Current version
 
 Download and install the current release of the Azure CLI.  After the installation is complete, you will need to close and reopen any active Windows Command Prompt or PowerShell windows to use the Azure CLI.
 
 > [!div class="nextstepaction"]
 > [Current release of the Azure CLI](https://aka.ms/installazurecliwindows)
 
+### Specific version
+
+To download the MSI installer for specific version, change the version segment in URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.29.1.msi and download it.
+
 ### Azure CLI beta version
 
 The beta version of the Azure CLI supports all commands and will stay in sync with the current released version.  For installation instructions, see [Install Azure CLI beta version](install-azure-cli-beta.md). 
@@ -59,6 +63,8 @@ Start PowerShell as administrator and run the following command:
 
 This will download and install the latest version of the Azure CLI for Windows. If you already have a version installed, the installer will update the existing version.
 
+To install specific version, replace the `-Uri` argument with https://azcliprod.blob.core.windows.net/msi/azure-cli-2.29.1.msi with version segment changed.
+
 > [!Note]
 > After the installation is complete, you will need to reopen PowerShell to use the Azure CLI.
 
diff --git a/docs-ref-conceptual/run-azure-cli-docker.md b/docs-ref-conceptual/run-azure-cli-docker.md
index 025ba4f9d8..118d2ea2c5 100644
--- a/docs-ref-conceptual/run-azure-cli-docker.md
+++ b/docs-ref-conceptual/run-azure-cli-docker.md
@@ -37,11 +37,15 @@ Install the CLI using `docker run`.
 > docker run -it -v ${HOME}/.ssh:/root/.ssh mcr.microsoft.com/azure-cli
 > ```
 
-The CLI is installed on the image as the `az` command in `/usr/local/bin`. To sign in, run the [az login](/cli/azure/reference-index#az_login) command.
+## Install specific version
 
-[!INCLUDE [interactive-login](includes/interactive-login.md)]
+To install specific version:
 
-To learn more about different authentication methods, see [Sign in with the Azure CLI](authenticate-azure-cli.md).
+```bash
+docker run -it mcr.microsoft.com/azure-cli:2.29.1
+```
+
+[!INCLUDE [interactive-login](includes/interactive-login.md)]
 
 ## Update Docker image
 

From f855aa3e51ab52b6e2ed732bbc220a80e6536ca8 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Tue, 26 Oct 2021 17:14:35 +0800
Subject: [PATCH 2/7] update

---
 .../includes/cli-install-linux-apt.md            | 16 ++++++++--------
 .../includes/cli-install-linux-dnf.md            | 16 ++++++++--------
 .../includes/cli-install-linux-zypper.md         | 16 ++++++++--------
 docs-ref-conceptual/install-azure-cli-macos.md   |  9 ---------
 4 files changed, 24 insertions(+), 33 deletions(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-apt.md b/docs-ref-conceptual/includes/cli-install-linux-apt.md
index 997463cc4b..af0dab533a 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-apt.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-apt.md
@@ -73,17 +73,17 @@ If you prefer a step-by-step installation process, complete the following steps
 
 You must first configure `azure-cli` repository information as shown above.
 
-To view available versions:
+1. To view available versions:
 
-```bash
-apt-cache policy azure-cli
-```
+    ```bash
+    apt-cache policy azure-cli
+    ```
 
-To install specific version:
+2. To install specific version:
 
-```bash
-sudo apt-get install azure-cli=2.29.1-1~bullseye
-```
+    ```bash
+    sudo apt-get install azure-cli=2.29.1-1~bullseye
+    ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
 
diff --git a/docs-ref-conceptual/includes/cli-install-linux-dnf.md b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
index 712a95b6f7..8180416c44 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-dnf.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
@@ -49,17 +49,17 @@ for the Azure CLI. This package has been tested with RHEL 7.7, RHEL 8, Fedora 24
 
 You must first configure `azure-cli` repository information as shown above.
 
-To view available versions:
+1. To view available versions:
 
-```bash
-dnf --showduplicates list azure-cli
-```
+   ```bash
+   dnf list --showduplicates azure-cli
+   ```
 
-To install specific version:
+2. To install specific version:
 
-```bash
-sudo dnf install azure-cli-2.29.1-1.el7
-```
+   ```bash
+   sudo dnf install azure-cli-2.29.1-1.el7
+   ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
 
diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index a7d75dfc98..609862ca05 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -50,17 +50,17 @@ for the Azure CLI. This package has been tested with openSUSE Leap 15.1, and SLE
 
 You must first configure `azure-cli` repository information first as shown above.
 
-To view available versions:
+1. To view available versions:
 
-```bash
-zypper search --details --match-exact azure-cli
-```
+   ```bash
+   zypper search --details --match-exact azure-cli
+   ```
 
-To install specific version:
+2. To install specific version:
 
-```bash
-sudo zypper install --from azure-cli azure-cli=2.29.1-1.el7
-```
+   ```bash
+   sudo zypper install --from azure-cli azure-cli=2.29.1-1.el7
+   ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
 
diff --git a/docs-ref-conceptual/install-azure-cli-macos.md b/docs-ref-conceptual/install-azure-cli-macos.md
index fc758184b8..2121559f22 100644
--- a/docs-ref-conceptual/install-azure-cli-macos.md
+++ b/docs-ref-conceptual/install-azure-cli-macos.md
@@ -38,15 +38,6 @@ brew update && brew install azure-cli
 > The Azure CLI is guaranteed to be compatible with the latest version of `python3`
 > published on Homebrew.
 
-## Install specific version
-
-To install specific version:
-
-```bash
-curl -L https://raw.githubusercontent.com/azclibot/homebrew-core/azcli2.29.1/Formula/azure-cli.rb > azure-cli.rb
-brew install --build-from-source azure-cli.rb
-```
-
 [!INCLUDE [interactive-login](includes/interactive-login.md)]
 
 ## Troubleshooting

From 6e10c714b41fcb572972ebd5b95ff9c865e22df0 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Mon, 1 Nov 2021 11:17:57 +0800
Subject: [PATCH 3/7] Use <version>

---
 docs-ref-conceptual/includes/cli-install-linux-apt.md  |  2 +-
 docs-ref-conceptual/includes/cli-install-linux-dnf.md  |  2 +-
 .../includes/cli-install-linux-zypper.md               |  6 +++---
 docs-ref-conceptual/install-azure-cli-windows.md       | 10 +++++-----
 docs-ref-conceptual/run-azure-cli-docker.md            |  4 ++--
 5 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-apt.md b/docs-ref-conceptual/includes/cli-install-linux-apt.md
index af0dab533a..88b8ff9219 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-apt.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-apt.md
@@ -82,7 +82,7 @@ You must first configure `azure-cli` repository information as shown above.
 2. To install specific version:
 
     ```bash
-    sudo apt-get install azure-cli=2.29.1-1~bullseye
+    sudo apt-get install azure-cli=<version>-1~bullseye
     ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
diff --git a/docs-ref-conceptual/includes/cli-install-linux-dnf.md b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
index 8180416c44..913e02cb36 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-dnf.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
@@ -58,7 +58,7 @@ You must first configure `azure-cli` repository information as shown above.
 2. To install specific version:
 
    ```bash
-   sudo dnf install azure-cli-2.29.1-1.el7
+   sudo dnf install azure-cli-<version>-1.el7
    ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index 609862ca05..92edd4a2a8 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -5,7 +5,7 @@ manager: barbkess
 ms.date: 11/24/2020
 ms.topic: include
 ms.service: azure-cli
-ms.devlang: azurecli 
+ms.devlang: azurecli
 ms.custom: devx-track-azurecli
 ---
 
@@ -59,7 +59,7 @@ You must first configure `azure-cli` repository information first as shown above
 2. To install specific version:
 
    ```bash
-   sudo zypper install --from azure-cli azure-cli=2.29.1-1.el7
+   sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    ```
 
 [!INCLUDE [interactive-login](interactive-login.md)]
@@ -120,7 +120,7 @@ allow HTTPS connections to the following addresses:
 
 ### SSL certificate problem
 
-When a certificate is broken or outdated on a machine, you may receive an error indicating that curl failed to verify the legitimacy of the server and therefore could not establish a secure connection.  Update your certificate to correct the problem.  
+When a certificate is broken or outdated on a machine, you may receive an error indicating that curl failed to verify the legitimacy of the server and therefore could not establish a secure connection.  Update your certificate to correct the problem.
 
 ```bach
 sudo zypper update-ca-certificates
diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md
index b94e0d2f40..fa18cc6722 100644
--- a/docs-ref-conceptual/install-azure-cli-windows.md
+++ b/docs-ref-conceptual/install-azure-cli-windows.md
@@ -8,14 +8,14 @@ ms.prod: azure
 ms.date: 08/19/2021
 ms.topic: conceptual
 ms.devlang: azurecli
-ms.technology: azure-cli 
+ms.technology: azure-cli
 ms.custom: devx-track-azurecli, seo-azure-cli
 keywords: Install azure cli, azure cli download, cli for windows, install azure cli on windows, azure cli windows, install azure cli windows
 ---
 
 # Install Azure CLI on Windows
 
-The Azure Command-Line Interface (CLI) is a cross-platform command-line tool that can be installed locally on Windows computers. You can use the Azure CLI for Windows to connect to Azure and execute administrative commands on Azure resources. The Azure CLI for Windows can also be used from a browser through the Azure Cloud Shell or run from inside a Docker container. 
+The Azure Command-Line Interface (CLI) is a cross-platform command-line tool that can be installed locally on Windows computers. You can use the Azure CLI for Windows to connect to Azure and execute administrative commands on Azure resources. The Azure CLI for Windows can also be used from a browser through the Azure Cloud Shell or run from inside a Docker container.
 
 For Windows, the Azure CLI is installed via a MSI, which gives you access to the CLI through the Windows Command Prompt (CMD) or PowerShell.
 When installing for Windows Subsystem for Linux (WSL), packages are available for your Linux distribution. See the [main install page](install-azure-cli.md)
@@ -40,11 +40,11 @@ Download and install the current release of the Azure CLI.  After the installati
 
 ### Specific version
 
-To download the MSI installer for specific version, change the version segment in URL https://azcliprod.blob.core.windows.net/msi/azure-cli-2.29.1.msi and download it.
+To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` and download it.
 
 ### Azure CLI beta version
 
-The beta version of the Azure CLI supports all commands and will stay in sync with the current released version.  For installation instructions, see [Install Azure CLI beta version](install-azure-cli-beta.md). 
+The beta version of the Azure CLI supports all commands and will stay in sync with the current released version.  For installation instructions, see [Install Azure CLI beta version](install-azure-cli-beta.md).
 
 # [Microsoft Installer (MSI) with Command](#tab/azure-powershell)
 
@@ -63,7 +63,7 @@ Start PowerShell as administrator and run the following command:
 
 This will download and install the latest version of the Azure CLI for Windows. If you already have a version installed, the installer will update the existing version.
 
-To install specific version, replace the `-Uri` argument with https://azcliprod.blob.core.windows.net/msi/azure-cli-2.29.1.msi with version segment changed.
+To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` with version segment changed.
 
 > [!Note]
 > After the installation is complete, you will need to reopen PowerShell to use the Azure CLI.
diff --git a/docs-ref-conceptual/run-azure-cli-docker.md b/docs-ref-conceptual/run-azure-cli-docker.md
index 118d2ea2c5..c14004ac00 100644
--- a/docs-ref-conceptual/run-azure-cli-docker.md
+++ b/docs-ref-conceptual/run-azure-cli-docker.md
@@ -20,7 +20,7 @@ with an isolated environment to run the CLI in. The image can also be used as a
 ## Install Azure CLI in Docker
 
 > [!NOTE]
-> The Azure CLI has migrated to [Microsoft Container Registry](https://azure.microsoft.com/services/container-registry). 
+> The Azure CLI has migrated to [Microsoft Container Registry](https://azure.microsoft.com/services/container-registry).
 > Existing tags on Docker Hub are still supported, but new releases will only be available as mcr.microsoft.com/azure-cli.
 
 Install the CLI using `docker run`.
@@ -42,7 +42,7 @@ Install the CLI using `docker run`.
 To install specific version:
 
 ```bash
-docker run -it mcr.microsoft.com/azure-cli:2.29.1
+docker run -it mcr.microsoft.com/azure-cli:<version>
 ```
 
 [!INCLUDE [interactive-login](includes/interactive-login.md)]

From a13cf6d9bfe7efaba801f74b2dbd21701906e882 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Mon, 1 Nov 2021 11:36:54 +0800
Subject: [PATCH 4/7] revert

---
 docs-ref-conceptual/includes/cli-install-linux-apt.md    | 2 --
 docs-ref-conceptual/includes/cli-install-linux-dnf.md    | 2 --
 docs-ref-conceptual/includes/cli-install-linux-script.md | 8 +-------
 docs-ref-conceptual/includes/cli-install-linux-zypper.md | 2 --
 docs-ref-conceptual/includes/interactive-login.md        | 6 ------
 docs-ref-conceptual/install-azure-cli-macos.md           | 4 +---
 docs-ref-conceptual/install-azure-cli-windows.md         | 7 +------
 docs-ref-conceptual/run-azure-cli-docker.md              | 4 ++--
 8 files changed, 5 insertions(+), 30 deletions(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-apt.md b/docs-ref-conceptual/includes/cli-install-linux-apt.md
index 88b8ff9219..0484f64de9 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-apt.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-apt.md
@@ -85,8 +85,6 @@ You must first configure `azure-cli` repository information as shown above.
     sudo apt-get install azure-cli=<version>-1~bullseye
     ```
 
-[!INCLUDE [interactive-login](interactive-login.md)]
-
 ## Troubleshooting
 
 Here are some common problems seen when installing with `apt`. If you experience a problem not covered here, [file an issue on github](https://github.com/Azure/azure-cli/issues).
diff --git a/docs-ref-conceptual/includes/cli-install-linux-dnf.md b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
index 913e02cb36..172d695928 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-dnf.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
@@ -61,8 +61,6 @@ You must first configure `azure-cli` repository information as shown above.
    sudo dnf install azure-cli-<version>-1.el7
    ```
 
-[!INCLUDE [interactive-login](interactive-login.md)]
-
 ## Troubleshooting
 
 Here are some common problems seen when installing with `dnf`. If you experience a problem not covered here, [file an issue on GitHub](https://github.com/Azure/azure-cli/issues).
diff --git a/docs-ref-conceptual/includes/cli-install-linux-script.md b/docs-ref-conceptual/includes/cli-install-linux-script.md
index 19bb248e6c..c2ae0aa48d 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-script.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-script.md
@@ -5,7 +5,7 @@ manager: barbkess
 ms.date: 12/15/2020
 ms.topic: include
 ms.service: azure-cli
-ms.devlang: azurecli 
+ms.devlang: azurecli
 ms.custom: devx-track-azurecli
 ---
 
@@ -37,12 +37,6 @@ curl -L https://aka.ms/InstallAzureCli | bash
 
 The script can also be downloaded and run locally. You may have to restart your shell in order for changes to take effect.
 
-You can then run the Azure CLI with the `az` command. To sign in, use [az login](/cli/azure/reference-index#az_login) command.
-
-[!INCLUDE [interactive-login](interactive-login.md)]
-
-To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
-
 ## Troubleshooting
 
 Here are some common problems seen during a manual installation. If you experience a problem not covered here, [file an issue on GitHub](https://github.com/Azure/azure-cli/issues).
diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index 92edd4a2a8..eaab3917f3 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -62,8 +62,6 @@ You must first configure `azure-cli` repository information first as shown above
    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    ```
 
-[!INCLUDE [interactive-login](interactive-login.md)]
-
 ## Troubleshooting
 
 Here are some common problems seen when installing with `zypper`. If you experience a problem not covered here, [file an issue on GitHub](https://github.com/Azure/azure-cli/issues).
diff --git a/docs-ref-conceptual/includes/interactive-login.md b/docs-ref-conceptual/includes/interactive-login.md
index 660ccd4e6f..d4f072b0da 100644
--- a/docs-ref-conceptual/includes/interactive-login.md
+++ b/docs-ref-conceptual/includes/interactive-login.md
@@ -5,10 +5,6 @@ manager: carmonm
 ms.date: 09/07/2018
 ms.topic: include
 ---
-## Sign in to Azure with the Azure CLI
-
-You can then run the Azure CLI with the `az` command. To sign in, use [`az login`](/cli/azure/reference-index#az_login) command.
-
 1. Run the `login` command.
 
     ```azurecli-interactive
@@ -23,5 +19,3 @@ You can then run the Azure CLI with the `az` command. To sign in, use [`az login
     If no web browser is available or the web browser fails to open, use device code flow with **az login --use-device-code**.
 
 2. Sign in with your account credentials in the browser.
-
-To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
diff --git a/docs-ref-conceptual/install-azure-cli-macos.md b/docs-ref-conceptual/install-azure-cli-macos.md
index 2121559f22..e5e7308bb2 100644
--- a/docs-ref-conceptual/install-azure-cli-macos.md
+++ b/docs-ref-conceptual/install-azure-cli-macos.md
@@ -7,7 +7,7 @@ manager: barbkess
 ms.date: 08/19/2021
 ms.topic: conceptual
 ms.service: azure-cli
-ms.devlang: azurecli 
+ms.devlang: azurecli
 ms.custom: devx-track-azurecli, seo-azure-cli
 keywords: Install azure cli, azure cli macos, macos cli, install azure cli macos
 ---
@@ -38,8 +38,6 @@ brew update && brew install azure-cli
 > The Azure CLI is guaranteed to be compatible with the latest version of `python3`
 > published on Homebrew.
 
-[!INCLUDE [interactive-login](includes/interactive-login.md)]
-
 ## Troubleshooting
 
 If you encounter a problem when installing the CLI through Homebrew, here are some common errors. If you experience a problem not covered here, [file an issue on github](https://github.com/Azure/azure-cli/issues).
diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md
index fa18cc6722..b640b3e9ad 100644
--- a/docs-ref-conceptual/install-azure-cli-windows.md
+++ b/docs-ref-conceptual/install-azure-cli-windows.md
@@ -75,12 +75,7 @@ To install specific version, replace the `-Uri` argument with `https://azcliprod
 
 ## Run the Azure CLI
 
-You can now run the Azure CLI with the `az` command from either Windows Command Prompt or PowerShell. PowerShell offers some tab completion features
-not available from Windows Command Prompt. To sign in, run the [az login](/cli/azure/reference-index#az_login) command.
-
-[!INCLUDE [interactive-login](includes/interactive-login.md)]
-
-To learn more about different authentication methods, see [Sign in with Azure CLI](authenticate-azure-cli.md).
+You can now run the Azure CLI with the `az` command from either Windows Command Prompt or PowerShell.
 
 ## Troubleshooting
 
diff --git a/docs-ref-conceptual/run-azure-cli-docker.md b/docs-ref-conceptual/run-azure-cli-docker.md
index c14004ac00..7d3f6c82ad 100644
--- a/docs-ref-conceptual/run-azure-cli-docker.md
+++ b/docs-ref-conceptual/run-azure-cli-docker.md
@@ -37,6 +37,8 @@ Install the CLI using `docker run`.
 > docker run -it -v ${HOME}/.ssh:/root/.ssh mcr.microsoft.com/azure-cli
 > ```
 
+The CLI is installed on the image as the `az` command in `/usr/local/bin`.
+
 ## Install specific version
 
 To install specific version:
@@ -45,8 +47,6 @@ To install specific version:
 docker run -it mcr.microsoft.com/azure-cli:<version>
 ```
 
-[!INCLUDE [interactive-login](includes/interactive-login.md)]
-
 ## Update Docker image
 
 Updating with Docker requires both pulling the new image and re-creating any existing containers. For this reason, you should

From 55242b85be31848d79d72e1f24d93e9b8f057403 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Mon, 1 Nov 2021 11:56:56 +0800
Subject: [PATCH 5/7] Available versions

---
 docs-ref-conceptual/includes/cli-install-linux-apt.md    | 4 ++--
 docs-ref-conceptual/includes/cli-install-linux-dnf.md    | 4 ++--
 docs-ref-conceptual/includes/cli-install-linux-zypper.md | 4 ++--
 docs-ref-conceptual/install-azure-cli-windows.md         | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-apt.md b/docs-ref-conceptual/includes/cli-install-linux-apt.md
index 0484f64de9..f0f381edc3 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-apt.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-apt.md
@@ -71,9 +71,9 @@ If you prefer a step-by-step installation process, complete the following steps
 
 ## Install specific version
 
-You must first configure `azure-cli` repository information as shown above.
+You must first configure `azure-cli` repository information as shown above. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
-1. To view available versions:
+1. To view available versions with command:
 
     ```bash
     apt-cache policy azure-cli
diff --git a/docs-ref-conceptual/includes/cli-install-linux-dnf.md b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
index 172d695928..c33f428e45 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-dnf.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-dnf.md
@@ -47,9 +47,9 @@ for the Azure CLI. This package has been tested with RHEL 7.7, RHEL 8, Fedora 24
 
 ## Install specific version
 
-You must first configure `azure-cli` repository information as shown above.
+You must first configure `azure-cli` repository information as shown above. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
-1. To view available versions:
+1. To view available versions with command:
 
    ```bash
    dnf list --showduplicates azure-cli
diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index eaab3917f3..603451d769 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -48,9 +48,9 @@ for the Azure CLI. This package has been tested with openSUSE Leap 15.1, and SLE
 
 ## Install specific version
 
-You must first configure `azure-cli` repository information first as shown above.
+You must first configure `azure-cli` repository information first as shown above. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
-1. To view available versions:
+1. To view available versions with command:
 
    ```bash
    zypper search --details --match-exact azure-cli
diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md
index b640b3e9ad..f1bc21b5bb 100644
--- a/docs-ref-conceptual/install-azure-cli-windows.md
+++ b/docs-ref-conceptual/install-azure-cli-windows.md
@@ -40,7 +40,7 @@ Download and install the current release of the Azure CLI.  After the installati
 
 ### Specific version
 
-To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` and download it.
+To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` and download it. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
 ### Azure CLI beta version
 
@@ -63,7 +63,7 @@ Start PowerShell as administrator and run the following command:
 
 This will download and install the latest version of the Azure CLI for Windows. If you already have a version installed, the installer will update the existing version.
 
-To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` with version segment changed.
+To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi` with version segment changed. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
 > [!Note]
 > After the installation is complete, you will need to reopen PowerShell to use the Azure CLI.

From d0f308d3d92db4661be73d96fcff55adfcd93c69 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Mon, 1 Nov 2021 11:59:28 +0800
Subject: [PATCH 6/7] update

---
 docs-ref-conceptual/includes/cli-install-linux-zypper.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs-ref-conceptual/includes/cli-install-linux-zypper.md b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
index 603451d769..45e049067c 100644
--- a/docs-ref-conceptual/includes/cli-install-linux-zypper.md
+++ b/docs-ref-conceptual/includes/cli-install-linux-zypper.md
@@ -48,7 +48,7 @@ for the Azure CLI. This package has been tested with openSUSE Leap 15.1, and SLE
 
 ## Install specific version
 
-You must first configure `azure-cli` repository information first as shown above. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
+You must first configure `azure-cli` repository information as shown above. Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
 
 1. To view available versions with command:
 

From 0d8547676e64766aeffe8133453ab1a4919fdc35 Mon Sep 17 00:00:00 2001
From: jiasli <4003950+jiasli@users.noreply.github.com>
Date: Mon, 1 Nov 2021 12:03:21 +0800
Subject: [PATCH 7/7] docker

---
 docs-ref-conceptual/run-azure-cli-docker.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs-ref-conceptual/run-azure-cli-docker.md b/docs-ref-conceptual/run-azure-cli-docker.md
index 7d3f6c82ad..702a323b7d 100644
--- a/docs-ref-conceptual/run-azure-cli-docker.md
+++ b/docs-ref-conceptual/run-azure-cli-docker.md
@@ -41,6 +41,8 @@ The CLI is installed on the image as the `az` command in `/usr/local/bin`.
 
 ## Install specific version
 
+Available versions can be found at [Azure CLI release notes](/cli/azure/release-notes-azure-cli).
+
 To install specific version:
 
 ```bash