edit pass: microsoft-dev-box-docset-how-to

Author: ShawnJackson

articles/dev-box/how-to-configure-azure-compute-gallery.md

@@ -45,7 +45,7 @@ To learn more about Azure Compute Gallery and how to create galleries, see:
 > - If you have existing images that don't meet the Windows 365 image requirements, those images won't be listed for image creation.
 > - Microsoft Dev Box Preview doesn't support community galleries.
 
-## Provide permissions for services to access the gallery
+## Provide permissions for services to access a gallery
 
 When you use an Azure Compute Gallery image to create a dev box definition, the Windows 365 service validates the image to ensure that it meets the requirements to be provisioned for a dev box. The Dev Box Preview service replicates the image to the regions specified in the attached network connections, so the images are present in the region that's required for dev box creation.
 
@@ -103,13 +103,13 @@ Use the following steps to manually assign each role.
    | --- | --- |
    | **Role** | Select **Contributor**. |
    | **Assign access to** | Select **Managed Identity**. |
-   | **Members** | Search for and select the user-assigned managed identity that you created when you [added a user-assigned identity to the dev center](#add-a-user-assigned-identity-to-dev-center). |
+   | **Members** | Search for and select the user-assigned managed identity that you created when you [added a user-assigned identity to the dev center](#add-a-user-assigned-identity-to-the-dev-center). |
 
 You can use the same managed identity in multiple dev centers and compute galleries. Any dev center with the managed identity added will have the necessary permissions to the images in the gallery that you've added the Owner role assignment to.
 
 ## Attach a gallery to a dev center
 
-To use the images from a gallery in dev box definitions, you must first associate the gallery with the dev center.
+To use the images from a gallery in dev box definitions, you must first associate the gallery with the dev center by attaching it:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
@@ -133,7 +133,7 @@ To use the images from a gallery in dev box definitions, you must first associat
 
 8. Select **Add**.
 
-   Your gallery now appears on the **Azure compute galleries** page.
+9. Confirm that your gallery now appears on the **Azure compute galleries** page.
 
    :::image type="content" source="media/how-to-configure-azure-compute-gallery/gallery-grid.png" alt-text="Screenshot that shows the page for compute galleries page with example galleries listed.":::
 

articles/dev-box/how-to-customize-devbox-azure-image-builder.md

@@ -13,7 +13,7 @@ ms.topic: how-to
 
 # Configure a dev box by using Azure VM Image Builder
 
-By using standardized virtual machine (VM) images, your organization can more easily migrate to the cloud and help ensure consistency in your deployments.
+When your organization uses standardized virtual machine (VM) images, it can more easily migrate to the cloud and help ensure consistency in your deployments.
 
 Images ordinarily include predefined security, configuration settings, and any necessary software. Setting up your own imaging pipeline requires time, infrastructure, and many other details. With Azure VM Image Builder, you can create a configuration that describes your image. The service then builds the image and submits it to a dev box project.
 
@@ -29,13 +29,13 @@ To reduce the complexity of creating VM images, VM Image Builder:
 
 - Can fetch customization data from various sources, which removes the need to collect them all from one place.
 
-- Can be integrated with Azure Compute Gallery. Compute Gallery creates an image management system with for distributing, replicating, versioning, and scaling images globally. Additionally, you can distribute the same resulting image as a virtual hard disk or as one or more managed images, without having to rebuild them from scratch.
+- Can be integrated with Azure Compute Gallery, which creates an image management system for distributing, replicating, versioning, and scaling images globally. Additionally, you can distribute the same resulting image as a virtual hard disk or as one or more managed images, without having to rebuild them from scratch.
 
 ## Prerequisites
 
 To provision a custom image that you created by using VM Image Builder, you need:
 
-- Owner or Contributor permissions on an Azure subscription or a specific resource group.
+- Owner or Contributor permissions on an Azure subscription or on a specific resource group.
 - A resource group.
 - A dev center with an attached network connection. If you don't have a one, follow the steps in [Create a network connection](./quickstart-configure-dev-box-service.md#create-a-network-connection).
 

articles/dev-box/how-to-dev-box-user.md

@@ -28,7 +28,7 @@ A DevCenter Dev Box User can:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev box**. In the search results, select **Projects**.
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
 1. Select the project that you want to give your team members access to.
 
@@ -48,7 +48,7 @@ A DevCenter Dev Box User can:
 
     :::image type="content" source="media/how-to-dev-box-user/add-role-assignment-user.png" alt-text="Screenshot that shows the pane for adding role assignments.":::
 
-The user can now view the project and all the pools within it. Dev box users can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
+The users can now view the project and all the pools within it. Dev box users can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
 
 [!INCLUDE [dev box runs on creation note](./includes/note-dev-box-runs-on-creation.md)]
 

articles/dev-box/how-to-manage-dev-box-definitions.md

@@ -13,15 +13,15 @@ ms.topic: how-to
 
 # Manage a dev box definition
 
-A dev box definition is a Microsoft Dev Box Preview resource that specifies a source image, compute size, and storage size. You can use a source image from Azure Marketplace or a custom image from Azure Compute Gallery.
+A dev box definition is a Microsoft Dev Box Preview resource that specifies a source image, compute size, and storage size.
 
 Depending on their task, development teams have different software, configuration, compute, and storage requirements. You can create a new dev box definition to fulfill each team's needs. There's no limit to the number of dev box definitions that you can create, and you can use dev box definitions across multiple projects in a dev center.
 
 ## Permissions
 
 To manage a dev box definition, you need the following permissions:
 
-|Action|Permission required|
+|Action|Permissions required|
 |-----|-----|
 |Create, delete, or update a dev box definition|Owner, Contributor, or Write permissions on the dev center in which you want to create the dev box definition. |
 
@@ -37,14 +37,16 @@ When you're selecting an Azure Marketplace image, consider using an image that h
 
 ### Azure Compute Gallery
 
-Azure Compute Gallery enables you to store and manage a collection of custom images. You can build an image to your dev team's exact requirements and store it in a gallery. To use the custom image while creating a dev box definition, attach the gallery to your dev center. To learn how to attach a gallery, see [Configure Azure Compute Gallery](how-to-configure-azure-compute-gallery.md).
+Azure Compute Gallery enables you to store and manage a collection of custom images. You can build an image to your dev team's exact requirements and store it in a gallery.
+
+To use the custom image while creating a dev box definition, attach the gallery to your dev center. To learn how to attach a gallery, see [Configure Azure Compute Gallery](how-to-configure-azure-compute-gallery.md).
 
 ## Image versions
 
-When you select an image to use in your dev box definition, you must specify if you'll use updated versions of the image:
+When you select an image to use in your dev box definition, you must specify whether you'll use updated versions of the image:
 
-- **Numbered image versions:** If you want a consistent dev box definition in which the base image doesn't change, use a specific, numbered version of the image. Using a numbered version ensures that all the dev boxes in the pool always use the same version of the image.
-- **Latest image versions:** If you want a flexible dev box definition in which you can update the base image as needs change, use the latest version of the image. This choice ensures that new dev boxes use the most recent version of the image. Existing dev boxes aren't modified when an image version is updated.
+- **Numbered image versions**: If you want a consistent dev box definition in which the base image doesn't change, use a specific, numbered version of the image. Using a numbered version ensures that all the dev boxes in the pool always use the same version of the image.
+- **Latest image versions**: If you want a flexible dev box definition in which you can update the base image as needs change, use the latest version of the image. This choice ensures that new dev boxes use the most recent version of the image. Existing dev boxes aren't modified when an image version is updated.
 
 ## Create a dev box definition
 
@@ -78,7 +80,7 @@ The following steps show you how to create a dev box definition by using an exis
 
    :::image type="content" source="./media/how-to-manage-dev-box-definitions/recommended-test-image.png" alt-text="Screenshot that shows the pane for creating a dev box definition.":::
 
-1. To finish creating the dev box definition, select **Create**.
+1. Select **Create**.
 
 ## Update a dev box definition
 

articles/dev-box/how-to-manage-dev-box-pools.md

@@ -19,7 +19,7 @@ To enable developers to self-serve dev boxes from projects, you must configure d
 
 To manage a dev box pool, you need the following permissions:
 
-|Action|Permission required|
+|Action|Permissions required|
 |-----|-----|
 |Create, delete, or update a dev box pool|Owner or Contributor permissions on an Azure subscription or a specific resource group. </br> DevCenter Project Admin permissions for the project.|
 
@@ -81,7 +81,7 @@ You can delete a dev box pool when you're no longer using it.
 
 1. Open the project from which you want to delete the dev box pool.
 
-1. Select the dev box pool you that want to delete, and then select **Delete**.
+1. Select the dev box pool you that you want to delete, and then select **Delete**.
 
    :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-delete.png" alt-text="Screenshot of a selected dev box pool in the list of dev box pools, along with the Delete button.":::
 

articles/dev-box/how-to-manage-dev-boxes.md

@@ -12,7 +12,7 @@ ms.topic: how-to
 
 # Manage a dev box by using the developer portal
 
-You can preconfigure a dev box to manage all of your tools, services, source code, and prebuilt binaries specific to your project. Microsoft Dev Box Preview provides an environment that's ready to build on, so you can run your app in minutes.
+You can preconfigure a dev box to manage all of your tools, services, source code, and prebuilt binaries that are specific to your project. Microsoft Dev Box Preview provides an environment that's ready to build on, so you can run your app in minutes.
 
 ## Permissions
 
@@ -28,7 +28,9 @@ Create a dev box through the developer portal. You can create as many dev boxes
 
 You could create a dev box for your front-end work and a separate dev box for your back-end work. You could also create multiple dev boxes for your back end.
 
-For example, say you're working on a bug. You could a separate dev box for the bug fix to work on the specific task and troubleshoot the issue without poisoning your primary machine.
+For example, say you're working on a bug. You could use a separate dev box for the bug fix to work on the specific task and troubleshoot the issue without poisoning your primary machine.
+
+To create a dev box:
 
 [!INCLUDE [create a dev box](./includes/create-dev-box.md)]
 
@@ -40,7 +42,7 @@ After you create your dev box, you can connect to it through a Remote Desktop ap
 
 For most cases, use the Remote Desktop app when you're accessing a dev box. Remote Desktop provides the highest performance and best user experience for heavy workloads. For more information, see [Quickstart: Use a Remote Desktop client to connect to a dev box](./quickstart-connect-to-dev-box-with-remote-desktop-app.md).
 
-Use the browser for lighter workloads. When you access your dev box via your phone or computer, you can use the browser. The browser is useful for tasks such as a quick bug fix or a review of a GitHub pull request. For more information, see the [steps for using a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box).
+Use the browser for lighter workloads. When you access your dev box via your phone or laptop, you can use the browser. The browser is useful for tasks such as a quick bug fix or a review of a GitHub pull request. For more information, see the [steps for using a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box).
 
 ## Delete a dev box
 
@@ -57,5 +59,5 @@ You can delete dev boxes after you finish your tasks. Say you finished fixing yo
 
 ## Next steps
 
-- [Quickstart: Use a remote desktop client to connect to a dev box](./quickstart-connect-to-dev-box-with-remote-desktop-app.md)
+- [Use a remote desktop client to connect to a dev box](./quickstart-connect-to-dev-box-with-remote-desktop-app.md)
 - [Use a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box)

articles/dev-box/how-to-manage-dev-center.md

@@ -19,11 +19,11 @@ Development teams vary in the way they function and might have different needs.
 
 To manage a dev center, you need the following permissions:
 
-|Action|Permission required|
+|Action|Permissions required|
 |-----|-----|
-|Create or delete dev center|Owner or Contributor permissions on an Azure subscription or a specific resource group.|
-|Manage a dev center|Owner or Contributor role, or specific write permission to the dev center.|
-|Attach or remove network connection|Network Contributor permissions on an existing network connection (Owner or Contributor).|
+|Create or delete a dev center|Owner or Contributor permissions on an Azure subscription or a specific resource group.|
+|Manage a dev center|Owner or Contributor role, or specific Write permission to the dev center.|
+|Attach or remove a network connection|Network Contributor permissions on an existing network connection (Owner or Contributor).|
 
 ## Create a dev center
 
@@ -41,16 +41,16 @@ To create a dev center:
 
    :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center.png" alt-text="Screenshot that shows the Create button on the page for dev centers.":::
 
-1. On the **Create a dev center** page, on the **Basics** tab, enter the following values:
+1. On the **Create a dev center** pane, on the **Basics** tab, enter the following values:
 
    |Name|Value|
    |----|----|
    |**Subscription**|Select the subscription in which you want to create the dev center.|
-   |**Resource group**|Select an existing resource group, or select **Create new** and then enter a name for the new resource group.|
+   |**ResourceGroup**|Select an existing resource group, or select **Create new** and then enter a name for the new resource group.|
    |**Name**|Enter a name for the dev center.|
    |**Location**|Select the location or region where you want to create the dev center.|
 
-   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-basics.png" alt-text="Screenshot that shows the Basics tab on the page for creating a dev center.":::
+   :::image type="content" source="./media/how-to-manage-dev-center/create-dev-center-basics.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a dev center.":::
 
    For a list of supported Azure locations with capacity, see [Frequently asked questions about Microsoft Dev Box](https://aka.ms/devbox_acom).