Update quickstart-configure-dev-box-service.md

ShawnJackson · web-flow · commit af6a64d1f600 · 2023-03-08T16:53:22.000-06:00
diff --git a/articles/dev-box/quickstart-configure-dev-box-service.md b/articles/dev-box/quickstart-configure-dev-box-service.md
@@ -48,7 +48,7 @@ Use the following steps to create a dev center so that you can manage your dev b
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **dev centers**. In the search results, select **Dev centers**.
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
 
    :::image type="content" source="./media/quickstart-configure-dev-box-service/discover-dev-centers.png" alt-text="Screenshot that shows the Azure portal with the search box and the result for dev centers.":::
 
@@ -77,7 +77,7 @@ Use the following steps to create a dev center so that you can manage your dev b
 
 1. On the **Review** tab, select **Create**.
 
-1. Check on the progress of the dev center creation from any page in the Azure portal by opening the **Notifications** pane.
+1. Monitor the progress of the dev center creation from any page in the Azure portal by opening the **Notifications** pane.
 
    :::image type="content" source="./media/quickstart-configure-dev-box-service/notifications-pane.png" alt-text="Screenshot that shows the Notifications pane in the Azure portal.":::
 
@@ -91,7 +91,9 @@ Network connections determine the region in which dev boxes are deployed. They a
 
 You must have a virtual network and subnet available for your network connection. To create them:
 
-1. In the search box, enter **virtual network**. In the search results, select **Virtual Network**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **virtual network**. In the list of results, select **Virtual Network**.
 
 1. On the **Virtual Network** page, select **Create**.
 
@@ -118,7 +120,9 @@ You now need a network connection to associate the virtual network and subnet wi
 
 #### [Azure AD join](#tab/AzureADJoin/)
 
-1. In the search box, enter **network connections**. In the search results, select **Network connections**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **network connections**. In the list of results, select **Network connections**.
 
 1. On the **Network connections** page, select **Create**.
 
@@ -141,11 +145,13 @@ You now need a network connection to associate the virtual network and subnet wi
 
 1. On the **Review** tab, select **Create**.
 
-1. When the deployment is complete, select **Go to resource**. The **Network Connection overview** page appears, which confirms that you created the connection.
+1. When the deployment is complete, select **Go to resource**. The network connection appears on the **Network connections** page.
 
 #### [Hybrid Azure AD join](#tab/HybridAzureADJoin/)
 
-1. In the search box, enter **network connections**. In the search results, select **Network connections**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **network connections**. In the list of results, select **Network connections**.
 
 1. On the **Network connections** page, select **Create**.
 
@@ -172,23 +178,25 @@ You now need a network connection to associate the virtual network and subnet wi
 
 1. On the **Review** tab, select **Create**.
 
-1. When the deployment is complete, select **Go to resource**. The **Network Connection overview** page appears, which confirms that you created the connection.
+1. When the deployment is complete, select **Go to resource**. The network connection appears on the **Network connections** page.
 
 ---
 
-## Attach the network connection to the dev center
+## Attach a network connection to a dev center
 
-To provide network configuration information for dev boxes, you need to associate a network connection with a dev center. Use the following steps to attach the network connection to your dev center:
+To provide network configuration information for dev boxes, associate a network connection with a dev center:
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **dev centers**. In the search results, select **Dev centers**.
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
 
 1. Select the dev center that you created, and then select **Networking**.
 
 1. Select  **+ Add**.
 
 1. On the **Add network connection** pane, select the network connection that you created, and then select **Add**.
 
-After you attach a network connection, the Azure portal runs several health checks on the network. You can view the status of the checks on the resource overview page. Network connections that pass all the health checks can be added to a dev center and used in the creation of dev box pools. The dev boxes within the dev box pools will be created and domain joined in the location of the virtual network that's assigned to the network connection.
+After you attach a network connection, the Azure portal runs several health checks on the network. You can view the status of the checks on the resource overview page. You can add network connections that pass all health checks to a dev center and use them to create dev box pools. Dev boxes that are in dev box pools are created and domain joined in the location of the virtual network that's assigned to the network connection.
 
 :::image type="content" source="./media/quickstart-configure-dev-box-service/network-connection-grid-populated.png" alt-text="Screenshot that shows the status of a network connection.":::
 
@@ -209,8 +217,8 @@ Dev box definitions define the image and SKU (compute + storage) that will be us
    |Name|Value|Note|
    |----|----|----|
    |**Name**|Enter a descriptive name for your dev box definition.|
-   |**Image**|Select the base operating system for the dev box. You can select an image from Azure Marketplace or from Azure Compute Gallery. </br> If you're creating a dev box definition for testing purposes, consider using the **Visual Studio 2022 Enterprise on Windows 11 Enterprise + Microsoft 365 Apps 22H2** image. |To access custom images while creating a dev box definition, you can use Azure Compute Gallery. For more information, see [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md).|
-   |**Image version**|Select a specific, numbered version to ensure that all the dev boxes in the pool always use the same version of the image. Select **Latest** to ensure that new dev boxes use the latest image available.|Selecting the **Latest** image version enables the dev box pool to use the most recent version of your chosen image from the gallery. This way, the created dev boxes will stay up to date with the latest tools and code on your image. Existing dev boxes aren't modified when an image version is updated.|
+   |**Image**|Select the base operating system for the dev box. You can select an image from Azure Marketplace or from Azure Compute Gallery. </br> If you're creating a dev box definition for testing purposes, consider using the **Visual Studio 2022 Enterprise on Windows 11 Enterprise + Microsoft 365 Apps 22H2** image. |To access custom images when you create a dev box definition, you can use Azure Compute Gallery. For more information, see [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md).|
+   |**Image version**|Select a specific, numbered version to ensure that all the dev boxes in the pool always use the same version of the image. Select **Latest** to ensure that new dev boxes use the latest image available.|Selecting the **Latest** image version enables the dev box pool to use the most recent version of your chosen image from the gallery. This way, the created dev boxes will stay up to date with the latest tools and code for your image. Existing dev boxes aren't modified when an image version is updated.|
    |**Compute**|Select the compute combination for your dev box definition.||
    |**Storage**|Select the amount of storage for your dev box definition.||
 
@@ -224,11 +232,13 @@ Dev box projects enable you to manage team-level settings. These settings includ
 
 To create and configure a project in a dev box:
 
-1. In the search box, enter **projects**. In the search results, select **Projects**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
 1. On the **Projects** page, select **Create**.
 
-1. On the **Create a project** page, on the **Basics** tab, enter the following values:
+1. On the **Create a project** pane, on the **Basics** tab, enter the following values:
 
    |Name|Value|
    |----|----|
@@ -238,7 +248,7 @@ To create and configure a project in a dev box:
    |**Name**|Enter a name for the project. |
    |**Description**|Enter a brief description of the project. |
 
-   :::image type="content" source="./media/quickstart-configure-dev-box-service/dev-box-project-create.png" alt-text="Screenshot that shows the Basics tab on the page for creating a dev box project.":::
+   :::image type="content" source="./media/quickstart-configure-dev-box-service/dev-box-project-create.png" alt-text="Screenshot that shows the Basics tab on the pane for creating a dev box project.":::
 
 1. (Optional) On the **Tags** tab, enter a name/value pair that you want to assign.
 
@@ -248,15 +258,17 @@ To create and configure a project in a dev box:
 
 1. Confirm that the project is created successfully by checking the notifications. Select **Go to resource**.
 
-1. Verify that you see the **Project** page.
+1. Verify that the project appears on the **Projects** page.
 
 ## Create a dev box pool
 
 A dev box pool is a collection of dev boxes that have similar settings. Dev box pools specify the dev box definitions and network connections that dev boxes will use. You must associate at least one pool with your project before users can create a dev box.
 
 To create a dev box pool that's associated with a project:
 
-1. In the search box, enter **projects**. In the search results, select **Projects**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
 1. Open the project in which you want to create the dev box pool.
   
@@ -266,22 +278,20 @@ To create a dev box pool that's associated with a project:
 
    :::image type="content" source="./media/quickstart-configure-dev-box-service/create-pool.png" alt-text="Screenshot of an empty list of dev box pools within a project, along with selections to start creating a pool.":::
 
-   :::image type="content" source="./media/quickstart-configure-dev-box-service/create-pool.png" alt-text="Screenshot that shows the list of dev box pools in a project. The list is empty.":::
-
 1. On the **Create a dev box pool** pane, enter the following values:
 
    |Name|Value|
    |----|----|
-   |**Name**|Enter a name for the pool. The pool name is visible to developers to select when they're creating dev boxes, and it must be unique within a project.|
-   |**Dev box definition**|Select an existing dev box definition. The definition determines the base image and size for the dev boxes created within this pool.|
-   |**Network connection**|Select an existing network connection. The network connection determines the region of the dev boxes created within this pool.|
+   |**Name**|Enter a name for the pool. The pool name is visible to developers to select when they're creating dev boxes. It must be unique within a project.|
+   |**Dev box definition**|Select an existing dev box definition. The definition determines the base image and size for the dev boxes that are created in this pool.|
+   |**Network connection**|Select an existing network connection. The network connection determines the region of the dev boxes that are created in this pool.|
    |**Dev box Creator Privileges**|Select **Local Administrator** or **Standard User**.|
    |**Enable Auto-stop**|**Yes** is the default. Select **No** to disable an auto-stop schedule. You can configure an auto-stop schedule after the pool is created.|
    |**Stop time**| Select a time to shut down all the dev boxes in the pool. All dev boxes in this pool will be shut down at this time every day.|
    |**Time zone**| Select the time zone that the stop time is in.|
    |**Licensing**| Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool. |
 
-   :::image type="content" source="./media/quickstart-configure-dev-box-service/create-pool-details.png" alt-text="Screenshot of the page for creating a dev box pool.":::
+   :::image type="content" source="./media/quickstart-configure-dev-box-service/create-pool-details.png" alt-text="Screenshot of the pane for creating a dev box pool.":::
 
 1. Select **Create**.
 
@@ -297,35 +307,39 @@ Before users can create dev boxes based on the dev box pools in a project, you m
 
 To assign roles:
 
-1. In the search box, enter **projects**. In the search results, select **Projects**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
 1. Select the project that you want to give team members access to.
 
    :::image type="content" source="./media/quickstart-configure-dev-box-service/select-project.png" alt-text="Screenshot of the list of existing projects.":::
 
-1. Select **Access control (IAM)** from the left menu.
+1. On the left menu, select **Access control (IAM)**.
 
    :::image type="content" source="./media/quickstart-configure-dev-box-service/project-permissions.png" alt-text="Screenshot that shows the page for project access control.":::
 
 1. On the command bar, select **Add** > **Add role assignment**.
 
 1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
 
-   |Setting  |Value  |
-   |---------|---------|
-   |**Role**     |    **DevCenter Dev Box User**    |
-   |**Assign access to**     |    User     |
-   |**Members**     |    Your account     |
+   | Setting | Value |
+   | --- | --- |
+   | **Role** | Select **DevCenter Dev Box User**. |
+   | **Assign access to** | Select **User, group, or service principal**. |
+   | **Members** | Select the users or groups that you want to be able to access to the project. |
+
+   :::image type="content" source="media/how-to-dev-box-user/add-role-assignment-user.png" alt-text="Screenshot that shows the pane for adding a role assignment.":::
 
    The user can now view the project and all the pools within it. The user can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
 
 [!INCLUDE [supported accounts note](./includes/note-supported-accounts.md)]
 
 ## Assign the Project Admin role
 
-The Microsoft Dev Box Preview service makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their teams, like creating and managing dev box pools. To give users permissions to manage projects, add them to the DevCenter Project Admin role.
+The Microsoft Dev Box Preview service makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their teams, like creating and managing dev box pools. To give users permissions to manage projects, assign the DevCenter Project Admin role to them.
 
-You can assign the DevCenter Project Admin role by using the steps described earlier in [Provide access to a dev box project](#provide-access-to-a-dev-box-project), but selecting the Project Admin role instead of the Dev Box User role. For more information, go to [Provide access to projects for project admins](how-to-project-admin.md).
+You can assign the DevCenter Project Admin role by using the steps described earlier in [Provide access to a dev box project](#provide-access-to-a-dev-box-project), but select the Project Admin role instead of the Dev Box User role. For more information, see [Provide access to projects for project admins](how-to-project-admin.md).
 
 [!INCLUDE [permissions note](./includes/note-permission-to-create-dev-box.md)]
 
