edits

Author: ktoliver

articles/deployment-environments/how-to-configure-use-cli.md

@@ -1,7 +1,7 @@
 ---
-title: Configure and use Deployment Environments Azure CLI extension
+title: Configure and use the Deployment Environments Azure CLI extension
 titleSuffix: Azure Deployment Environments
-description: Learn how to setup and use Deployment Environments Azure CLI extension to configure the Azure Deployment environments service.
+description: Learn how to set up and use the Azure Deployment Environments Preview Azure CLI extension to configure the Deployment Environments service.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
@@ -20,37 +20,42 @@ This article shows you how to use the Deployment Environments Azure CLI extensio
 ## Setup
 
 1. Install the Deployment Environments Azure CLI Extension:
-    - [Download and install the Azure CLI](/cli/azure/install-azure-cli).
-    - Install the Deployment Environments AZ CLI extension:
 
-    **Automated install**
+    1. [Download and install the Azure CLI](/cli/azure/install-azure-cli).
+    1. Install the Deployment Environments AZ CLI extension:
 
-    Execute the script https://aka.ms/DevCenter/Install-DevCenterCli.ps1 directly in PowerShell to install:
-    ```powershell
-    iex "& { $(irm https://aka.ms/DevCenter/Install-DevCenterCli.ps1 ) }"
-    ```
-    
-    This will uninstall any existing dev center extension and install the latest version.
+       - **Automated installation**
+
+         Execute the script https://aka.ms/DevCenter/Install-DevCenterCli.ps1 directly in PowerShell to install:
+
+         ```powershell
+         iex "& { $(irm https://aka.ms/DevCenter/Install-DevCenterCli.ps1 ) }"
+         ```
+  
+         Any existing dev center extension is uninstalled and the latest version is installed.
+
+      - **Manual installation**
 
-    **Manual install**
-    
-    Run the following command in the Azure CLI:
+          - Run the following command in the Azure CLI:
     ```azurecli
     az extension add --source https://fidalgosetup.blob.core.windows.net/cli-extensions/devcenter-0.1.0-py3-none-any.whl
     ```
-1. Sign in to Azure CLI.
+
+1. Sign in to the Azure CLI:
+
     ```azurecli
     az login
     ```
 
-1. Set the default subscription to the subscription where you'll be creating your specific Deployment Environment resources.
+1. Set the default subscription to the subscription in which you'll create your specific Deployment Environment resources.
+
     ```azurecli
     az account set --subscription {subscriptionId}
     ```
 
 ## Commands
 
-**Create a new resource group**
+### Create a new resource group
 
 ```azurecli
 az group create -l <region-name> -n <resource-group-name>
@@ -62,97 +67,98 @@ Optionally, set defaults (which means there is no need to pass the argument into
 az configure --defaults group=<resource-group-name>
 ```
 
-**Get help for a command**
+### Get help for a command
 
 ```azurecli
 az devcenter admin <command> --help
 ```
+
 ```azurecli
 az devcenter dev <command> --help
 ```
 
 ### Dev centers
 
-**Create a dev center with User Assigned identity**
+#### Create a dev center with user-assigned identity
 
 ```azurecli
 az devcenter admin devcenter create --identity-type "UserAssigned" --user-assigned-identity
     "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/identityGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity1" --location <location-name> -g <resource-group-name> - <name>
 ```
 
-**Create a dev center with System Assigned identity**
+#### Create a dev center with system-assigned identity
 
 ```azurecli
 az devcenter admin devcenter create --location <location-name> -g <resource-group-name> -n <name> \
     --identity-type "SystemAssigned"
 ```
 
-**List dev centers (in the selected subscription if resource group is not specified or configured in defaults)**
+#### List dev centers (in the selected subscription if resource group is not specified or configured in defaults)
 
 ```azurecli
 az devcenter admin devcenter list --output table
 ```
 
-**List dev centers (in the specified resource group)**
+#### List dev centers (in the specified resource group)
 
 ```azurecli
 az devcenter admin devcenter list -g <resource-group-name>
 ```
 
-**Get a specific dev center**
+#### Get a specific dev center
 
 ```azurecli
 az devcenter admin devcenter show -g <resource-group-name> --name <name>
 ```
 
-**Delete a dev center**
+#### Delete a dev center
 
 ```azurecli
 az devcenter admin devcenter delete -g <resource-group-name> --name <name>
 ```
 
-**Force delete a dev center**
+#### Force-delete a dev center
 
 ```azurecli
 az devcenter admin devcenter delete -g <resource-group-name> --name <name> --yes
 ```
 
-### Environment Types
+### Environment types
 
-**Create an Environment Type**
+#### Create an environment type
 
 ```azurecli
 az devcenter admin environment-type create --dev-center-name <devcenter-name> -g <resource-group-name> --name <name>
 ```
 
-**List environment types by dev center**
+#### List environment types by dev center
 
 ```azurecli
 az devcenter admin environment-type list --dev-center-name <devcenter-name> --resource-group <resource-group-name>
 ```
 
-**List environment types by project**
+#### List environment types by project
 
 ```azurecli
 az devcenter admin environment-type list --project-name <devcenter-name> --resource-group <resource-group-name>
 ```
 
-**Delete an environment type**
+#### Delete an environment type
 
 ```azurecli
 az devcenter admin environment-type delete --dev-center-name <devcenter-name> --name "{environmentTypeName}" \
     --resource-group <resource-group-name>
 ```
 
-**List environment types by dev center and project for developers**
+#### List environment types by dev center and project for developers
 
 ```azurecli
 az devcenter dev environment list --dev-center <devcenter-name> --project-name <project-name>
 ```
 
 ### Project Environment Types
 
-**Create project environment types**
+#### Create project environment types
 
 ```azurecli
 az devcenter admin project-environment-type create --description "Developer/Testing environment" --dev-center-name \
@@ -161,27 +167,27 @@ az devcenter admin project-environment-type create --description "Developer/Test
     --status Enabled --type SystemAssigned
 ```
 
-**List project environment types by dev center**
+#### List project environment types by dev center
 
 ```azurecli
 az devcenter admin project-environment-type list --dev-center-name <devcenter-name> \
     --resource-group <resource-group-name>
 ```
 
-**List project environment types by project**
+#### List project environment types by project
 
 ```azurecli
 az devcenter admin project-environment-type list --project-name <project-name> --resource-group <resource-group-name>
 ```
 
-**Delete project environment types**
+#### Delete project environment types
 
 ```azurecli
 az devcenter admin project-environment-type delete --project-name <project-name> \
     --environment-type-name "{environmentTypeName}" --resource-group <resource-group-name>
 ```
 
-**List allowed project environment types**
+#### List allowed project environment types
 
 ```azurecli
 az devcenter admin project-allowed-environment-type list --project-name <project-name> \
@@ -190,73 +196,73 @@ az devcenter admin project-allowed-environment-type list --project-name <project
 
 ### Catalogs
 
-**Create a catalog with a GitHub repository**
+#### Create a catalog with a GitHub repository
 
 ```azurecli
 az devcenter admin catalog create --git-hub secret-identifier="https://<key-vault-name>.azure-int.net/secrets/<secret-name>" uri=<git-clone-uri> branch=<git-branch> -g <resource-group-name> --name <name> --dev-center-name <devcenter-name>
 ```
 
-**Create a catalog with a Azure DevOps repository**
+#### Create a catalog with a Azure DevOps repository
 
 ```azurecli
 az devcenter admin catalog create --ado-git secret-identifier="https://<key-vault-name>.azure-int.net/secrets/<secret-name>" uri=<git-clone-uri> branch=<git-branch> -g <resource-group-name> --name <name> --dev-center-name <devcenter-name>
 ```
 
-**Sync a catalog**
+#### Sync a catalog
 
 ```azurecli
 az devcenter admin catalog sync  --name <name> --dev-center-name <devcenter-name> -g <resource-group-name>
 ```
 
-**List catalogs in a dev center**
+#### List catalogs in a dev center
 
 ```azurecli
 az devcenter admin catalog list -g <resource-group-name> --dev-center-name <devcenter-name>
 ```
 
-**Delete a catalog**
+#### Delete a catalog
 
 ```azurecli
 az devcenter admin catalog delete -g <resource-group-name> --dev-center-name <devcenter-name> -n <name>
 ```
 
 ### Catalog items
 
-**List catalog items available in a project**
+#### List catalog items available in a project
 
 ```azurecli
 az devcenter dev catalog-item list --dev-center-name <devcenter-name> --project-name <name>
 ```
 
 ### Project
 
-**Create a project**
+#### Create a project
 
 ```azurecli
 az devcenter admin project create -g <resource-group-name> -n <project-name> --dev-center-id <devcenter-resource-id>
 ```
 
-**List projects (in the selected subscription if resource group is not specified or configured in defaults)**
+#### List projects (in the selected subscription if resource group is not specified or configured in defaults)
 
 ```azurecli
 az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects' | project id, name"
 ```
 
-**List projects (in the specified resource group)**
+#### List projects (in the specified resource group)
 
 ```azurecli
 az devcenter admin project list -g <resource-group-name>
 ```
 
-**Delete a project**
+#### Delete a project
 
 ```azurecli
 az devcenter admin project delete -g <resource-group-name> --name <project-name>
 ```
 
 ### Environments
 
-**Create an environment**
+#### Create an environment
 
 ```azurecli
 az devcenter dev environment create --dev-center-name <devcenter-name> \
@@ -265,20 +271,20 @@ az devcenter dev environment create --dev-center-name <devcenter-name> \
     --parameters <deployment-parameters-json-string>
 ```
 
-**Deploy an environment**
+#### Deploy an environment
 
 ```azurecli
 az devcenter environment deploy-action --action-id "deploy" --dev-center <devcenter-name> \
     -g <resource-group-name> --project-name <project-name> -n <name> --parameters <parameters-json-string>
 ```
 
-**List environments in a project**
+### List environments in a project
 
 ```azurecli
 az devcenter dev environment list --dev-center <devcenter-name> --project-name <project-name>
 ```
 
-**Delete an environment**
+#### Delete an environment
 
 ```azurecli
 az devcenter dev environment delete --dev-center <devcenter-name>  --project-name <project-name> -n <name> --user-id "me"