edits

ktoliver · ktoliver · commit d1ff3d26ca43 · 2023-03-07T13:48:47.000-08:00
diff --git a/articles/deployment-environments/how-to-configure-catalog.md b/articles/deployment-environments/how-to-configure-catalog.md
@@ -151,7 +151,7 @@ An invalid catalog item error might occur for various reasons:
 
   - Ensure that the manifest's engine type is correctly configured as `ARM`.
   - Ensure that the catalog item name is between 3 and 63 characters.
-  - Ensure that the catalog item name includes only characters that are valid for a URL: alphanumeric characters and the symbols `~` `!` `,` `.` `'` `;` `:` `=` `-` `_` `+` `)` `(` `*` `&` `$` `@`.
+  - Ensure that the catalog item name includes only characters that are valid for a URL, which are alphanumeric characters and these symbols: `~` `!` `,` `.` `'` `;` `:` `=` `-` `_` `+` `(` `)` `*` `&` `$` `@`
   
 - **Reference errors**. Ensure that the template path that the manifest references is a valid relative path to a file in the repository.
 
diff --git a/articles/deployment-environments/how-to-configure-use-cli.md b/articles/deployment-environments/how-to-configure-use-cli.md
@@ -78,88 +78,88 @@ az devcenter admin <command> --help
 az devcenter dev <command> --help
 ```
 
-### Dev centers
+**Dev centers**
 
-#### Create a dev center by using a user-assigned identity
+### Create a dev center by using a 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 by using a system-assigned identity
+### Create a dev center by using a 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 specified resource group)
+### List dev centers (in the specified resource group)
 
 ```azurecli
 az devcenter admin devcenter list -g <resource-group-name>
 ```
 
-#### List dev centers (in the selected subscription if resource group isn't specified or configured in defaults)
+### List dev centers (in the selected subscription if resource group isn't specified or configured in defaults)
 
 ```azurecli
 az devcenter admin devcenter list --output table
 ```
 
-#### 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
+**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 \
@@ -168,20 +168,20 @@ 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> \
@@ -195,75 +195,75 @@ az devcenter admin project-allowed-environment-type list --project-name <project
     --resource-group <resource-group-name>
 ```
 
-### Catalogs
+**Catalogs**
 
-#### Create a catalog that uses a GitHub repository
+### Create a catalog that uses 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 that uses an Azure DevOps repository
+### Create a catalog that uses an 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
+**Catalog items**
 
-#### List catalog items that are available in a project
+### List catalog items that are available in a project
 
 ```azurecli
 az devcenter dev catalog-item list --dev-center-name <devcenter-name> --project-name <name>
 ```
 
-### Project
+**Projects**
 
-#### 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 specified resource group)
+### List projects (in the specified resource group)
 
 ```azurecli
 az devcenter admin project list -g <resource-group-name>
 ```
 
-#### List projects (in the selected subscription if resource group isn't specified or configured in defaults)
+### List projects (in the selected subscription if resource group isn't specified or configured in defaults)
 
 ```azurecli
 az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects' | project id, name"
 ```
 
-#### Delete a project
+### Delete a project
 
 ```azurecli
 az devcenter admin project delete -g <resource-group-name> --name <project-name>
 ```
 
-### Environments
+**Environments**
 
-#### Create an environment
+### Create an environment
 
 ```azurecli
 az devcenter dev environment create --dev-center-name <devcenter-name> \
@@ -272,7 +272,7 @@ 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> \
diff --git a/articles/deployment-environments/how-to-create-access-environments.md b/articles/deployment-environments/how-to-create-access-environments.md
@@ -26,23 +26,23 @@ This article shows you how to create and access an [environment](concept-environ
   1. [Download and install the Azure CLI](/cli/azure/install-azure-cli).
   1. Install the Azure Deployment Environments AZ CLI extension:
 
-     **Automated installation**
+     - **Automated installation**
   
-     In PowerShell, run the https://aka.ms/DevCenter/Install-DevCenterCli.ps1 script:
+       In PowerShell, run the https://aka.ms/DevCenter/Install-DevCenterCli.ps1 script:
 
-     ```powershell
-     iex "& { $(irm https://aka.ms/DevCenter/Install-DevCenterCli.ps1 ) }"
-     ```
+       ```powershell
+       iex "& { $(irm https://aka.ms/DevCenter/Install-DevCenterCli.ps1 ) }"
+       ```
   
-     The script uninstalls any existing dev center extension and installs the latest version.
+       The script uninstalls any existing dev center extension and installs the latest version.
 
-     **Manual installation**
+     - **Manual installation**
   
-     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
-     ```
+       ```azurecli
+       az extension add --source https://fidalgosetup.blob.core.windows.net/cli-extensions/devcenter-0.1.0-py3-none-any.whl
+       ```
 
 ## Create an environment
 
@@ -87,7 +87,7 @@ Complete the following steps in the Azure CLI to create an environment and confi
    az devcenter dev catalog-item list --dev-center <name> --project-name <name> -o table
    ```
 
-1. Create an environment by using a *catalog-item* (an infrastructure-as-code template defined in the [manifest.yaml](configure-catalog-item.md#add-a-new-catalog-item) file) from the list of available catalog items:
+1. Create an environment by using a *catalog-item* (an infrastructure as code template defined in the [manifest.yaml](configure-catalog-item.md#add-a-new-catalog-item) file) from the list of available catalog items:
 
    ```azurecli
    az devcenter dev environment create --dev-center-name <devcenter-name> 
diff --git a/articles/deployment-environments/how-to-manage-environments.md b/articles/deployment-environments/how-to-manage-environments.md
@@ -132,5 +132,5 @@ az devcenter dev environment delete --dev-center-name <devcenter-name>  --projec
 
 ## Next steps
 
-- Learn how to configure Azure Deployment Environments: [Quickstart: Create and configure a dev center](quickstart-create-and-configure-devcenter.md).
-- Learn more about managing your environments by using the CLI: [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md).
+- Learn how to configure Azure Deployment Environments in [Quickstart: Create and configure a dev center](quickstart-create-and-configure-devcenter.md).
+- Learn more about managing your environments by using the CLI in [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md).
diff --git a/articles/deployment-environments/quickstart-create-and-configure-devcenter.md b/articles/deployment-environments/quickstart-create-and-configure-devcenter.md
@@ -163,7 +163,7 @@ To add a catalog to your dev center, you first need to gather some information.
 To add a catalog, you must specify the GitHub repo URL, the branch, and the folder that contains your catalog items. You can gather this information before you begin the process of adding the catalog to the dev center, and paste it somewhere accessible, like notepad.
 
 > [!TIP] 
->  If you are attaching an Azure DevOps repository, use these steps: [Get the clone URL of an Azure DevOps repository](how-to-configure-catalog.md#get-the-clone-url-of-an-azure-devops-repository).
+>  If you are attaching an Azure DevOps repository, use these steps: [Get the clone URL of an Azure DevOps repository](how-to-configure-catalog.md#get-the-clone-url-of-an-azure-devops-git-repository).
 
 1. On your [GitHub](https://github.com) account page, select **<> Code**, and then select copy.
 1. Take a note of the branch that you're working in.
diff --git a/articles/deployment-environments/toc.yml b/articles/deployment-environments/toc.yml
@@ -5,7 +5,7 @@ items:
   expanded: true
   items: 
     - name: What is Azure Deployment Environments Preview?
-      displayName: ADE Overview
+      displayName: Azure Deployment Environments overview
       href: overview-what-is-azure-deployment-environments.md
 - name: Quickstarts
   displayName: Quickstarts
@@ -22,9 +22,9 @@ items:
   items:
     - name: Key concepts
       href: concept-environments-key-concepts.md
-    - name: Usage scenarios
+    - name: Use scenarios
       href: concept-environments-scenarios.md
-    - name: Components common to ADE and Dev Box
+    - name: Components common to Deployment Environments & Dev Box
       href: concept-common-components.md
 - name: How-to guides
   expanded: true
diff --git a/includes/ade-mdb-common-components/ade-mdb-common-components.md b/includes/ade-mdb-common-components/ade-mdb-common-components.md
@@ -28,17 +28,17 @@ As you work with Dev Box or Deployments Environments in the Azure portal, you ca
 
 In the dev center overview, you can access options to:
 
-- Configure your dev boxes.
+(1) Configure your dev boxes.
 
-- Configure your environments.
+(2) Configure your environments.
 
 :::image type="content" source="media/dev-center-overview.png" alt-text="Screenshot showing Dev Box and Deployment Environments components in a dev center.":::
 
 In the projects overview, you can access options to:
 
-- Configure environment types for a specific project.
+(1) Configure environment types for a specific project.
 
-- Manage dev box pools and environments.
+(2) Manage dev box pools and environments.
 
 :::image type="content" source="media/project-overview.png" alt-text="Screenshot showing Dev Box and Deployment Environments components in a project.":::
 
