Integrating Nick's feedback for ADE and MDB

RoseHJM · RoseHJM · commit d1e977703d51 · 2023-03-31T16:47:26.000-07:00
diff --git a/articles/deployment-environments/concept-common-components.md b/articles/deployment-environments/concept-common-components.md
@@ -1,7 +1,6 @@
 ---
-title: Common components Microsoft Dev Box
-titleSuffix: Azure Deployment Environments
-description: Discover the components that are shared by Azure Deployment Environments Preview and Microsoft Dev Box.
+title: Components common to Microsoft Dev Box and Azure Deployment Environments
+description: Discover the components that are shared by Azure Deployment Environments and Microsoft Dev Box.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.topic: conceptual
diff --git a/articles/deployment-environments/concept-environments-key-concepts.md b/articles/deployment-environments/concept-environments-key-concepts.md
@@ -10,7 +10,7 @@ author: RoseHJM
 ms.date: 10/12/2022
 ---
 
-# Key concepts for new Azure Deployment Environments Preview
+# Key concepts for Azure Deployment Environments Preview
 
 Learn about the key concepts and components of Azure Deployment Environments Preview. This knowledge can help you more effectively deploy environments for your scenarios.
 
diff --git a/articles/deployment-environments/concept-environments-scenarios.md b/articles/deployment-environments/concept-environments-scenarios.md
@@ -1,7 +1,6 @@
 ---
-title: User scenarios for Azure Deployment Environments
-titleSuffix: Azure Deployment Environments
-description: Learn about scenarios enabled by Azure Deployment Environments.
+title: Usage scenarios for Azure Deployment Environments
+description: Learn how Azure Deployment Environments can be integrated into CI/CD pipelines, create sandboxes, and hackathon environments.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.topic: conceptual
@@ -43,7 +42,7 @@ In this scenario, Azure Deployment Environments provides the following benefits:
 - Teams can access a fully configured environment when it's needed. 
 - Developers can test the latest version of an application by using reusable templates to quickly create new ad hoc environments.
 
-## Trainings, hands-on labs, and hackathons
+## Training, hands-on labs, and hackathons
 
 A project in Azure Deployment Environments acts as a container for transient activities like workshops, hands-on labs, trainings, or hackathons. You can create a project to provide custom templates to each user.
 
diff --git a/articles/deployment-environments/configure-catalog-item.md b/articles/deployment-environments/configure-catalog-item.md
@@ -1,7 +1,7 @@
 ---
 title: Add and configure a catalog item 
 titleSuffix: Azure Deployment Environments
-description: Learn how to add and configure a catalog item in your repository to use in your Azure Deployment Environments Preview dev center projects.
+description: Learn how to add and configure a catalog item to use in your dev center projects. Catalog items contain an IaC template that defines the environment. 
 services: Azure Deployment Environments
 author: RoseHJM
 ms.author: rosemalcolm
@@ -12,7 +12,7 @@ ms.custom: devdivchpfy22, ignite-2022
 
 ---
 
-# Add and configure a catalog item 
+# Add and configure a catalog item in Azure Deployment Environments
 
 In Azure Deployment Environments Preview, you can use a [catalog](concept-environments-key-concepts.md#catalogs) to provide your development teams with a curated set of predefined [infrastructure as code (IaC)](/devops/deliver/what-is-infrastructure-as-code) templates called [*catalog items*](concept-environments-key-concepts.md#catalog-items).
 
diff --git a/articles/deployment-environments/how-to-configure-catalog.md b/articles/deployment-environments/how-to-configure-catalog.md
@@ -1,7 +1,7 @@
 ---
 title: Add and configure a catalog
 titleSuffix: Azure Deployment Environments
-description: Learn how to add and configure a catalog in your Azure Deployment Environments Preview dev center to provide deployment templates for your development teams. Catalogs are specialized repositories stored in GitHub or Azure DevOps.
+description: Learn how to add and configure a catalog in your Azure Deployment Environments dev center to provide deployment templates for your development teams. Catalogs are specialized repositories stored in GitHub or Azure DevOps.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 author: RoseHJM
diff --git a/articles/deployment-environments/how-to-configure-deployment-environments-user.md b/articles/deployment-environments/how-to-configure-deployment-environments-user.md
@@ -1,7 +1,7 @@
 ---
-title: Provide access to developers
+title: Provide user access to projects for developers
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure access for developers by using the Deployment Environments User built-in role.
+description: Learn how to configure access to projects for developers by using the Deployment Environments User built-in role.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
diff --git a/articles/deployment-environments/how-to-configure-devcenter-environment-types.md b/articles/deployment-environments/how-to-configure-devcenter-environment-types.md
@@ -1,7 +1,7 @@
 ---
 title: Configure dev center environment types
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure dev center environment types to define environments that your developers can deploy.
+description: Learn how to define dev center level permissions and deployment settings for the environments that developers can deploy.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
diff --git a/articles/deployment-environments/how-to-configure-managed-identity.md b/articles/deployment-environments/how-to-configure-managed-identity.md
@@ -1,7 +1,7 @@
 ---
 title: Configure a managed identity
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure a managed identity to deploy environments in your Azure Deployment Environments Preview dev center.
+description: Learn how to configure a managed identity to deploy environments in your Azure Deployment Environments dev center.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 author: RoseHJM
diff --git a/articles/deployment-environments/how-to-configure-project-admin.md b/articles/deployment-environments/how-to-configure-project-admin.md
@@ -1,7 +1,7 @@
 ---
-title: Provide access for dev managers to projects
+title: Provide administrative access to projects
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure access for dev managers by using the DevCenter Project Admin built-in role.
+description: Learn how to configure administrative access for dev managers by using the DevCenter Project Admin built-in role.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
diff --git a/articles/deployment-environments/how-to-configure-project-environment-types.md b/articles/deployment-environments/how-to-configure-project-environment-types.md
@@ -1,7 +1,7 @@
 ---
 title: Configure project environment types
 titleSuffix: Azure Deployment Environments
-description: Learn how to add, update, and delete project environment types in Azure Deployment Environments. Project level environment types define deployment settings and permissions available to developers when they're deploying environments in a project.
+description: Learn how to add, update, and delete project environment types in Azure Deployment Environments. Define project-level deployment settings and permissions.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
diff --git a/articles/deployment-environments/how-to-create-access-environments.md b/articles/deployment-environments/how-to-create-access-environments.md
@@ -1,7 +1,7 @@
 ---
 title: Create and access an environment by using the Azure CLI
 titleSuffix: Azure Deployment Environments
-description: Learn how to create and access an environment in an Azure Deployment Environments Preview project by using the Azure CLI.
+description: Learn how to create and access an environment in an Azure Deployment Environments project by using the Azure CLI.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: deployment-environments
diff --git a/articles/deployment-environments/how-to-install-devcenter-cli-extension.md b/articles/deployment-environments/how-to-install-devcenter-cli-extension.md
@@ -1,7 +1,7 @@
 ---
 title: Install the devcenter Azure CLI extension
-titleSuffix: Azure Deployment Environments Preview
-description: Learn how to install the Azure CLI and the Azure Deployment Environments Preview CLI extension so you can create Deployment Environments resources from the command line.
+titleSuffix: Azure Deployment Environments 
+description: Learn how to install the Azure CLI and the Azure Deployment Environments CLI extension so you can create Deployment Environments resources from the command line.
 services: deployment-environments
 ms.service: deployment-environments
 ms.topic: how-to
diff --git a/articles/deployment-environments/how-to-manage-environments.md b/articles/deployment-environments/how-to-manage-environments.md
@@ -1,7 +1,7 @@
 ---
 title: Manage your environment
 titleSuffix: Azure Deployment Environments
-description: Learn how to manage your Azure Deployment Environments Preview deployment environment in the developer portal or by using the Azure CLI.
+description: Learn how to manage your Azure Deployment Environments deployment environment in the developer portal or by using the Azure CLI.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: deployment-environments
diff --git a/articles/deployment-environments/overview-what-is-azure-deployment-environments.md b/articles/deployment-environments/overview-what-is-azure-deployment-environments.md
@@ -1,7 +1,7 @@
 ---
 title: What is Azure Deployment Environments?
 titleSuffix: Azure Deployment Environments
-description: 'Azure Deployment Environments enables developer teams to quickly spin up app infrastructure with project-based templates, minimizing setup time while maximizing security, compliance, and cost efficiency.'
+description: Enable developer teams to spin up app infrastructure with project-based templates, minimize setup time & maximize security, compliance, and cost efficiency.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.topic: overview
diff --git a/articles/deployment-environments/quickstart-create-access-environments.md b/articles/deployment-environments/quickstart-create-access-environments.md
@@ -1,7 +1,7 @@
 ---
 title: Create and access an environment in the developer portal
 titleSuffix: Azure Deployment Environments
-description: Learn how to create and access an environment in an Azure Deployment Environments Preview project.
+description: Learn how to create and access an environment in an Azure Deployment Environments project through the developer portal.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: deployment-environments
@@ -10,7 +10,7 @@ ms.topic: quickstart
 ms.date: 10/26/2022
 ---
 
-# Quickstart: Create and access an environment by using the developer portal
+# Quickstart: Create and access Azure Deployment Environments by using the developer portal
 
 This quickstart shows you how to create and access an [environment](concept-environments-key-concepts.md#environments) in an existing Azure Deployment Environments Preview project.
 
diff --git a/articles/deployment-environments/quickstart-create-and-configure-devcenter.md b/articles/deployment-environments/quickstart-create-and-configure-devcenter.md
@@ -1,7 +1,7 @@
 ---
 title: Create and configure a dev center
 titleSuffix: Azure Deployment Environments
-description: Learn how to create and configure a dev center in Azure Deployment Environments Preview. In the quickstart, you create a dev center, attach an identity, attach a catalog, and create environment types.
+description: Learn how to create and configure a dev center in Azure Deployment Environments. In the quickstart, you create a dev center, attach an identity, attach a catalog, and create environment types.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.topic: quickstart
@@ -10,7 +10,7 @@ ms.custom: ignite-2022
 ms.date: 02/08/2023
 ---
 
-# Quickstart: Create and configure a dev center for Deployment Environments
+# Quickstart: Create and configure a dev center for Azure Deployment Environments
 
 This quickstart shows you how to create and configure a dev center in Azure Deployment Environments Preview.
 
diff --git a/articles/deployment-environments/quickstart-create-and-configure-projects.md b/articles/deployment-environments/quickstart-create-and-configure-projects.md
@@ -1,7 +1,7 @@
 ---
 title: Create and configure a project
 titleSuffix: Azure Deployment Environments
-description: Learn how to create a project in Azure Deployment Environments Preview and associate the project with a dev center.
+description: Learn how to create a project in Azure Deployment Environments and associate the project with a dev center.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: deployment-environments
diff --git a/articles/deployment-environments/toc.yml b/articles/deployment-environments/toc.yml
@@ -22,24 +22,24 @@ items:
   items:
     - name: Key concepts
       href: concept-environments-key-concepts.md
-    - name: Use scenarios
+    - name: Usage scenarios
       href: concept-environments-scenarios.md
     - name: Components common to Deployment Environments & Dev Box
       href: concept-common-components.md
 - name: How-to guides
   expanded: true
   items:
-    - name: Add and configure a catalog
+    - name: Add & configure a catalog
       href: how-to-configure-catalog.md
-    - name: Add and configure a catalog item
+    - name: Add & configure a catalog item
       href: configure-catalog-item.md
     - name: Configure a managed identity
       href: how-to-configure-managed-identity.md
     - name: Configure dev center environment types
       href: how-to-configure-devcenter-environment-types.md
-    - name: Add and delete project environment types
+    - name: Add & delete project environment types
       href: how-to-configure-project-environment-types.md
-    - name: Provide access to Dev Managers
+    - name: Provide access to dev managers
       href: how-to-configure-project-admin.md
     - name: Provide access to developers
       href: how-to-configure-deployment-environments-user.md
diff --git a/articles/dev-box/concept-common-components.md b/articles/dev-box/concept-common-components.md
@@ -1,6 +1,5 @@
 ---
-title: Common components Azure Deployment Environments
-titleSuffix: Microsoft Dev Box
+title: Components common to Azure Deployment Environments and Microsoft Dev Box
 description: Discover the components shared by Microsoft Dev Box and Azure Deployment Environments.
 ms.service: dev-box
 ms.custom: ignite-2022
diff --git a/articles/dev-box/concept-dev-box-concepts.md b/articles/dev-box/concept-dev-box-concepts.md
@@ -1,7 +1,6 @@
 ---
-title: Microsoft Dev Box Preview key concepts
-titleSuffix: Microsoft Dev Box
-description: Learn key concepts and terminology for Microsoft Dev Box Preview.
+title: Microsoft Dev Box key concepts
+description: Learn key concepts and terminology for Microsoft Dev Box.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
@@ -12,9 +11,9 @@ ms.custom: template-concept
 #Customer intent: As a developer, I want to understand Dev Box concepts and terminology so that I can set up a Dev Box environment.
 ---
 
-# Microsoft Dev Box Preview key concepts
+# Key concepts for Microsoft Dev Box Preview
 
-This article describes the key concepts and components of Microsoft Dev Box Preview.
+This article describes the key concepts and components of Microsoft Dev Box.
 
 ## Dev box
 
diff --git a/articles/dev-box/how-to-configure-azure-compute-gallery.md b/articles/dev-box/how-to-configure-azure-compute-gallery.md
@@ -1,7 +1,7 @@
 ---
 title: Configure Azure Compute Gallery
 titleSuffix: Microsoft Dev Box
-description: Learn how to create a repository for managing and sharing Dev Box images.
+description: Learn how to create an Azure Compute Gallery repository for managing and sharing Dev Box images.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
@@ -10,7 +10,7 @@ ms.date: 10/17/2022
 ms.topic: how-to
 ---
 
-# Configure Azure Compute Gallery
+# Configure Azure Compute Gallery for Microsoft Dev Box
 
 Azure Compute Gallery is a service for managing and sharing images. A gallery is a repository that's stored in your Azure subscription and helps you build structure and organization around your image resources. You can use a gallery to provide custom images for your dev box users.
 
diff --git a/articles/dev-box/how-to-configure-stop-schedule.md b/articles/dev-box/how-to-configure-stop-schedule.md
@@ -1,5 +1,5 @@
 ---
-title: Set an auto-stop schedule for dev boxes
+title: Set a dev box auto-stop schedule
 titleSuffix: Microsoft Dev Box
 description: Learn how to configure an auto-stop schedule to automatically shutdown dev boxes in a pool at a specified time.
 services: dev-box
diff --git a/articles/dev-box/how-to-create-dev-boxes-developer-portal.md b/articles/dev-box/how-to-create-dev-boxes-developer-portal.md
@@ -1,5 +1,5 @@
 ---
-title: Create and configure a dev box by using the developer portal
+title: Create & configure a dev box by using the developer portal
 titleSuffix: Microsoft Dev Box
 description: Learn how to create, delete, and connect to Microsoft Dev Box Preview dev boxes by using the developer portal.
 services: dev-box
diff --git a/articles/dev-box/how-to-dev-box-user.md b/articles/dev-box/how-to-dev-box-user.md
@@ -1,7 +1,7 @@
 ---
-title: Grant access to dev box projects for dev box users
+title: Provide user access to dev box projects
 titleSuffix: Microsoft Dev Box
-description: Learn how to provide access to projects for dev box users so that they can create and manage dev boxes.
+description: Learn how to provide user-level access to projects for developers so that they can create and manage dev boxes.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
@@ -10,7 +10,7 @@ ms.date: 10/12/2022
 ms.topic: how-to
 ---
 
-# Provide access to projects for dev box users
+# Provide user-level access to projects for developers
 
 Team members must have access to a specific Microsoft Dev Box Preview project before they can create dev boxes. By using the built-in DevCenter Dev Box User role, you can assign permissions to Active Directory users or groups at the project level.
 
diff --git a/articles/dev-box/how-to-install-dev-box-cli.md b/articles/dev-box/how-to-install-dev-box-cli.md
@@ -1,7 +1,7 @@
 ---
-title: Install the Microsoft Dev Box Preview Azure CLI extension
+title: Install the Microsoft Dev Box Azure CLI extension
 titleSuffix: Microsoft Dev Box
-description: Learn how to install the Azure CLI and the Microsoft Dev Box Preview CLI extension so you can create Dev Box resources from the command line.
+description: Learn how to install the Azure CLI and the Microsoft Dev Box CLI extension so you can create Dev Box resources from the command line.
 services: dev-box
 ms.service: dev-box
 ms.topic: how-to
@@ -11,7 +11,7 @@ ms.date: 03/19/2023
 Customer intent: As a dev infra admin, I want to install the Dev Box CLI extension so that I can create Dev Box resources from the command line.
 ---
 
-# Microsoft Dev Box Preview Azure CLI extension
+# Configure Microsoft Dev Box from the command-line with the Azure CLI extension
 
 In addition to the Azure admin portal and the developer portal, you can use the Dev Box Azure CLI extension to create resources. Microsoft Dev Box and Azure Deployment Environments use the same Azure CLI extension, which is called `devcenter`.
 
diff --git a/articles/dev-box/how-to-manage-dev-box-definitions.md b/articles/dev-box/how-to-manage-dev-box-definitions.md
@@ -1,7 +1,7 @@
 ---
 title: Create, update, delete dev box definitions
 titleSuffix: Microsoft Dev Box
-description: Learn how to create, update, and delete Microsoft Dev Box Preview dev box definitions.
+description: Microsoft Dev Box dev box definitions define a source image, compute size, and storage size for your dev boxes with. Learn how to manage dev box definitions.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
diff --git a/articles/dev-box/how-to-manage-dev-box-pools.md b/articles/dev-box/how-to-manage-dev-box-pools.md
@@ -1,7 +1,7 @@
 ---
 title: Manage a dev box pool
 titleSuffix: Microsoft Dev Box
-description: Learn how to create, configure and delete Microsoft Dev Box Preview dev box pools. 
+description: Microsoft Dev Box dev box pools are collections of dev boxes that you manage together. Learn how to create, configure, and delete dev box pools. 
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
diff --git a/articles/dev-box/how-to-manage-dev-box-projects.md b/articles/dev-box/how-to-manage-dev-box-projects.md
@@ -1,7 +1,7 @@
 ---
 title: Manage a dev box project
 titleSuffix: Microsoft Dev Box
-description: Learn how to create and delete Microsoft Dev Box Preview projects.
+description: Microsoft Dev Box projects give developers access to create their dev boxes. Learn how to create and delete dev box projects.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
diff --git a/articles/dev-box/how-to-manage-dev-center.md b/articles/dev-box/how-to-manage-dev-center.md
@@ -1,7 +1,7 @@
 ---
 title: Manage a dev center
 titleSuffix: Microsoft Dev Box
-description: This article describes how to create, delete, and manage Microsoft Dev Box Preview dev centers.
+description: Microsoft Dev Box dev centers help you manage dev box resources, grouping projects with similar settings. Learn how to create, delete, and manage dev centers.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
@@ -11,7 +11,7 @@ ms.topic: how-to
 #Customer intent: As a dev infrastructure manager, I want to be able to manage dev centers so that I can manage my Microsoft Dev Box Preview implementation.
 ---
 
-# Manage a dev center
+# Manage a Microsoft Dev Box dev center
 
 Development teams vary in the way they function and might have different needs. A dev center helps you manage these scenarios by enabling you to group similar sets of projects together and apply similar settings.
 
diff --git a/articles/dev-box/how-to-project-admin.md b/articles/dev-box/how-to-project-admin.md
@@ -1,7 +1,6 @@
 ---
-title: Provide administrative access to Dev Box projects
-titleSuffix: Microsoft Dev Box
-description: Learn how to manage multiple projects by assigning admin permissions and delegating project administration.
+title: Provide administrative access to Microsoft Dev Box projects
+description: Learn how to manage multiple Dev Box projects by assigning admin permissions and delegating project administration.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
diff --git a/articles/dev-box/overview-what-is-microsoft-dev-box.md b/articles/dev-box/overview-what-is-microsoft-dev-box.md
@@ -1,7 +1,6 @@
 ---
 title: What is Microsoft Dev Box?
-titleSuffix: Microsoft Dev Box
-description: Learn how Dev Box Preview gives self-service access to high-performance, preconfigured, and ready-to-code cloud-based workstations.
+description: Learn how Microsoft Dev Box Preview gives self-service access to high-performance, preconfigured, and ready-to-code cloud-based workstations.
 services: dev-box
 ms.service: dev-box
 ms.topic: overview
diff --git a/articles/dev-box/quickstart-configure-dev-box-service.md b/articles/dev-box/quickstart-configure-dev-box-service.md
@@ -1,6 +1,5 @@
 ---
 title: 'Quickstart: Configure Microsoft Dev Box'
-titleSuffix: Microsoft Dev Box
 description: In this quickstart, you learn how to configure the Microsoft Dev Box Preview service to provide dev boxes for users.
 services: dev-box
 ms.service: dev-box
diff --git a/articles/dev-box/toc.yml b/articles/dev-box/toc.yml
