Merge pull request #7982 from TimShererWithAquent/us421373-01

Freshness Edit: Azure DevOps 418726 (1 of 6)

Author: JamesJBarnett

docs/cli/index.md

@@ -1,55 +1,57 @@
 ---
-title: Learn about Azure DevOps command line interface extension
+title: Get Started with Azure DevOps CLI
 titleSuffix: Azure DevOps 
-description: Use Azure DevOps extension command line interface 
+description: Install the Azure DevOps extension command line interface. Learn how to sign on, configure defaults, access help, and open Azure DevOps services in a browser.
 ms.topic: quickstart
 ms.subservice: azure-devops-reference
 ms.manager: mijacobs 
 ms.author: chcomley  
 author: chcomley
 monikerRange: 'azure-devops'
-ms.date: 08/17/2020
+ms.date: 05/30/2025
+#customer intent: As a project team member, I want to set up Azure DevOps CLI and understand how to access pipelines, boards, repos, and artifacts. 
 ---
 
-# Get started with Azure DevOps CLI
+# Quickstart: Get started with Azure DevOps CLI
 
-[!INCLUDE [version-eq-azure-devops](../includes/version-eq-azure-devops.md)] 
+[!INCLUDE [version-eq-azure-devops](../includes/version-eq-azure-devops.md)]
 
-With the Azure DevOps extension for Azure Command Line Interface (CLI),  you can manage many Azure DevOps Services from the command line. CLI commands enable you to streamline your tasks with faster and flexible interactive canvas, bypassing user interface workflows.
+In this quickstart, you set up and start using the Azure DevOps extension for Azure Command Line Interface (CLI). With Azure CLI, you can manage many Azure DevOps Services from the command line. Azure CLI commands enable you to streamline your tasks with faster and flexible interactive canvas, bypassing user interface workflows.
 
 > [!NOTE]  
-> The Azure DevOps Command Line Interface (CLI) is only available for use with Azure DevOps Services. The Azure DevOps extension for the Azure CLI does not support any version of Azure DevOps Server. 
+> The Azure DevOps CLI is only available for use with Azure DevOps Services. The Azure DevOps extension for the Azure CLI doesn't support any version of Azure DevOps Server.
 
-To start using the Azure DevOps extension for Azure CLI, perform the following steps:
+To start using the Azure DevOps extension for Azure CLI:
 
-1. Install Azure CLI: Follow the instructions provided in [Install the Azure CLI](/cli/azure/install-azure-cli) to set up your Azure CLI environment. At a minimum, your Azure CLI version must be 2.10.1. You can use `az --version` to validate.
+1. Install Azure CLI. Follow the instructions in [Install the Azure CLI](/cli/azure/install-azure-cli) to set up your Azure CLI environment. At a minimum, your Azure CLI version must be 2.10.1. You can use the `az --version` command to validate.
 
-2. Add the Azure DevOps extension:
+1. Add the Azure DevOps extension.
 
-    ```
-	az extension add --name azure-devops
-    ```
+   ```azurecli
+   az extension add --name azure-devops
+   ```
 
-	You can use `az extension list` or `az extension show --name azure-devops` to confirm the installation.
+1. To confirm the installation, run the command `az extension list` or `az extension show --name azure-devops`.
 
-3. Sign in: Run `az login` to sign in. Note that we support only interactive or log in using user name and password with `az login`. To sign in using a Personal Access Token (PAT), see [Sign in via Azure DevOps Personal Access Token (PAT)](log-in-via-pat.md). 
+1. To sign in, run the `az login` command. Azure CLI supports only interactive sign-in using user name and password with `az login`. To sign in using a Personal Access Token (PAT), see [Sign in via Azure DevOps PAT](log-in-via-pat.md).
 
-> [!NOTE]  
-> The Azure DevOps extension does not currently support authenticating with [Managed Identities](../integrate/get-started/authentication/service-principal-managed-identity.md).
+   > [!NOTE]  
+   > The Azure DevOps extension doesn't currently support authenticating by using [Managed Identities](../integrate/get-started/authentication/service-principal-managed-identity.md).
 
-4. Configure defaults: We recommend you set the default configuration for your organization and project. Otherwise, you can set these within the individual commands themselves.  
+1. We recommend that you set the default configuration for your organization and project. Otherwise, you can specify the values in the individual commands themselves.  
 
-    ```
-	az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
-    ```
+   ```azurecli
+   az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
+   ```
 
-## Command usage
+## Use commands
 
 Adding the Azure DevOps Extension adds `devops`, `pipelines`, `artifacts`, `boards`, and `repos` groups.
-For usage and help content for any command, enter the **-h** parameter, for example:
+
+For usage and help content for any command, specify the `--help` parameter, for example:
 
 ```azurecli
-az devops -h
+az devops --help
 ```
 
 ```output
@@ -83,19 +85,17 @@ Commands:
 
 ## Open items in browser
 
-You can use `--open` switch to open any artifact in Azure DevOps portal in your default browser.
-
-For example :
+You can use `--open` parameter to open any artifact in Azure DevOps portal in your default browser.
 
 ```azurecli
 az pipelines build show --id 1 --open
 ```
 
-This command shows the details of build with `id 1` on the command-line and also opens it in the default browser.
+This command shows the details of the build with `--id 1` in the Command Prompt window and also opens it in the default browser.
 
 ## Related articles
 
-- [Sign in via Azure DevOps Personal Access Token (PAT)](log-in-via-pat.md)
-- [Output formats](/cli/azure/format-output-azure-cli)
-- [Index to az devops examples](quick-reference.md)
+- [Sign in via Azure DevOps personal access token](log-in-via-pat.md)
+- [Output formats for Azure CLI commands](/cli/azure/format-output-azure-cli)
+- [Index to az devops CLI examples](quick-reference.md)
 - [Azure DevOps CLI Extension GitHub Repo](https://github.com/Azure/azure-devops-cli-extension)