Merge pull request #230143 from ShawnJackson/microsoft-dev-box-docset-how-to

[AQ] edit pass: Microsoft Dev Box how-to articles

Author: ktoliver

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

@@ -1,5 +1,5 @@
 ---
-title: Provide access to dev box users
+title: Provide access for dev box users
 titleSuffix: Microsoft Dev Box Preview
 description: Learn how to provide access to projects for dev box users so that they can create and manage dev boxes.
 services: dev-box
@@ -12,7 +12,7 @@ ms.topic: how-to
 
 # Provide access to projects for dev box users
 
-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. 
+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.
 
 [!INCLUDE [supported accounts note](./includes/note-supported-accounts.md)]
 
@@ -27,30 +27,31 @@ A DevCenter Dev Box User can:
 ## Assign permissions to dev box users
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
- 
-1. In the search box, type *Dev box* and select **Projects**. 
 
-1. Select the project you want to provide your team members access to.
- 
-   :::image type="content" source="./media/how-to-dev-box-user/projects-grid.png" alt-text="Screenshot showing the list of existing 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.
+
+   :::image type="content" source="./media/how-to-dev-box-user/projects-grid.png" alt-text="Screenshot that shows a list of existing projects.":::
+
+1. On the left menu, select **Access Control (IAM)**.
 
-1. Select **Access Control (IAM)** from the left menu.
- 
 1. 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** | Select **DevCenter Dev Box User**. |
     | **Assign access to** | Select **User, group, or service principal**. |
-    | **Members** | Select the users or groups you want to have access to the project. |
+    | **Members** | Select the users or groups that you want to have 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 Add role assignment pane.":::
+    :::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 will now be able to 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)]
+
 ## Next steps
 
 - [Quickstart: Create a dev box by using the developer portal](quickstart-create-dev-box.md)

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

@@ -1,97 +1,96 @@
 ---
-title: How to manage a dev box pool
+title: Manage a dev box pool
 titleSuffix: Microsoft Dev Box Preview
-description: This article describes how to create, and delete Microsoft Dev Box Preview dev box pools.
+description: This article describes how to create and delete Microsoft Dev Box Preview dev box pools.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
 ms.date: 10/12/2022
 ms.topic: how-to
+#Customer intent: As a dev infrastructure manager, I want to be able to manage dev box pools so that I can provide appropriate dev boxes to my users.
 ---
 
-<!-- Intent: As a dev infrastructure manager, I want to be able to manage dev box pools so that I can provide appropriate dev boxes to my users. -->
-
 # Manage a dev box pool
-To enable developers to self-serve dev boxes from projects, you must configure dev box pools that specify the dev box definitions and network connections used when dev boxes are created. Dev box users create dev boxes from the dev box pools they have access to through their project memberships.
+
+To enable developers to self-serve dev boxes from projects, you must configure dev box pools that specify the dev box definitions and network connections for newly created dev boxes. Dev box users create dev boxes from the dev box pools that their project memberships give them access to.
 
 ## Permissions
+
 To manage a dev box pool, you need the following permissions:
 
-|Action|Permission required|
+|Action|Permissions required|
 |-----|-----|
-|Create, delete, or update dev box pool|Owner or Contributor permissions on an Azure Subscription or a specific resource group. </br> DevCenter Project Admin for the project.|
+|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.|
 
 ## Create a dev box pool
-A dev box pool is a collection of dev boxes that you manage together. You must have a pool before users can create a dev box.  
 
-The following steps show you how to create a dev box pool associated with a project. You'll use an existing dev box definition and network connection in the dev center to configure a dev box pool. 
+A dev box pool is a collection of dev boxes that you manage together. You must have a pool before users can create a dev box.  
 
-<!-- how many dev box pools can you create -->
+The following steps show you how to create a dev box pool that's associated with a project. You'll use an existing dev box definition and network connection in the dev center to configure the pool.
 
-If you don't have an available dev center with an existing dev box definition and network connection, follow the steps in [Quickstart: Configure the Microsoft Dev Box Preview service](quickstart-configure-dev-box-service.md) to create them.
+If you don't have an available dev center with an existing dev box definition and network connection, follow the steps in [Quickstart: Configure Microsoft Dev Box Preview](quickstart-configure-dev-box-service.md) to create them.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, type *Projects* and then select **Projects** from the list.
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-pools/discover-projects.png" alt-text="Screenshot showing a search for projects from the Azure portal search box.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-pools/discover-projects.png" alt-text="Screenshot that shows a search for projects from the Azure portal search box.":::
 
 1. Open the project with which you want to associate the new dev box pool.
 
    :::image type="content" source="./media/how-to-manage-dev-box-pools/projects-grid.png" alt-text="Screenshot of the list of existing projects.":::
 
-1. Select **Dev box pools** and then select **+ Create**.
- 
-   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-empty.png" alt-text="Screenshot of the list of dev box pools within a project. The list is empty.":::
+1. Select **Dev box pools**, and then select **Create**.
 
-1. On the **Create a dev box pool** page, enter the following values:
+   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-empty.png" alt-text="Screenshot of the empty list of dev box pools within a project, along with the Create button.":::
+
+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 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.|
-   |**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 has been created.|
-   |**Stop time**| Select a time to shutdown all the dev boxes in the 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.|
    |**Time zone**| Select the time zone that the stop time is in.|
-   |**Licensing**| Select this check box to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool. |
-
+   |**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/how-to-manage-dev-box-pools/dev-box-pool-create.png" alt-text="Screenshot of the Create dev box pool dialog."::: 
+   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-create.png" alt-text="Screenshot of the pane for creating a dev box pool.":::
 
 1. Select **Add**.
- 
-1. Verify that the new dev box pool appears in the list. You may need to refresh the screen.
 
-The dev box pool will be deployed and health checks will be run to ensure the image and network pass the validation criteria to be used for dev boxes. The screenshot below shows four dev box pools, each with a different status. 
+1. Verify that the new dev box pool appears in the list. You might need to refresh the screen.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-populated.png" alt-text="Screenshot showing a list of existing pools.":::
+The Azure portal deploys the dev box pool and runs health checks to ensure that the image and network pass the validation criteria for dev boxes. The following screenshot shows four dev box pools, each with a different status.
 
+:::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-grid-populated.png" alt-text="Screenshot that shows a list of dev box pools and status information.":::
 
 ## Delete a dev box pool
-You can delete a dev box pool when you're no longer using it. 
+
+You can delete a dev box pool when you're no longer using it.
 
 > [!CAUTION]
-> When you delete a dev box pool, all existing dev boxes within the pool will be permanently deleted.
+> When you delete a dev box pool, all existing dev boxes within the pool are permanently deleted.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, type *Projects* and then select **Projects** from the list.
+1. In the search box, enter **projects**. In the list of results, select **Projects**.
 
 1. Open the project from which you want to delete the dev box pool.
 
-1. Select the dev box pool 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 the list of existing dev box pools, with the one to be deleted selected.":::
+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.":::
 
-1.  In the confirmation message, select **Confirm**.
+1. In the confirmation message, select **Continue**.
 
-    :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-delete-confirm.png" alt-text="Screenshot of the Delete dev box pool confirmation message.":::
+    :::image type="content" source="./media/how-to-manage-dev-box-pools/dev-box-pool-delete-confirm.png" alt-text="Screenshot of the confirmation message for deleting a dev box pool.":::
 
 ## Next steps
 
 - [Provide access to projects for project admins](./how-to-project-admin.md)
 - [Create dev box definitions](./quickstart-configure-dev-box-service.md#create-a-dev-box-definition)
-- [Configure an Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md)
+- [Configure Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md)

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

@@ -1,7 +1,7 @@
 ---
-title: How to manage a dev box using the developer portal
+title: Manage a dev box by using the developer portal
 titleSuffix: Microsoft Dev Box
-description: This article describes how to create, delete, and connect to Microsoft Dev Box dev boxes using the developer portal.
+description: Learn how to create, delete, and connect to Microsoft Dev Box Preview dev boxes by using the developer portal.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
@@ -10,56 +10,54 @@ ms.date: 09/18/2022
 ms.topic: how-to
 ---
 
+# Manage a dev box by using the developer portal
 
-# Manage a dev box using the developer portal
-You can pre-configure a dev box to manage all of your tools, services, source-code and pre-built binaries specific to your project so you can immediately start working. Dev box enables you to get started quickly with 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
 
-As a dev box developer, you can: 
-- Create, view, and delete dev boxes you create
-- View pools within a project 
-- Connect to dev boxes
+As a dev box developer, you can:
+
+- Create, view, and delete dev boxes that you create.
+- View pools within a project.
+- Connect to dev boxes.
 
 ## Create a dev box
 
-Create a dev box through the developer portal. You can create as many dev boxes as you need, however there are common ways to split up your workload. 
+Create a dev box through the developer portal. You can create as many dev boxes as you need, but there are common ways to split up your workload.
 
-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. 
+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 were working on a bug. You could a separate dev box for the bug fix to work on the specific task, troubleshoot the issue and avoid 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)]
 
-
 ## Connect to a dev box
-Once you create your dev box, you can connect to it through the remote desktop app, or through the browser. 
 
-:::image type="content" source="./media/how-to-manage-dev-boxes/open-rdp-client.jpg" alt-text="Screenshot of dev box showing open an RDP client.":::
+After you create your dev box, you can connect to it through a Remote Desktop app or through a browser.
 
-For most cases, use the remote desktop app when accessing a dev box. The remote desktop provides the highest performance and best user-experience for heavy workloads. 
+:::image type="content" source="./media/how-to-manage-dev-boxes/open-rdp-client.jpg" alt-text="Screenshot of the option to open a dev box in an RDP client.":::
 
-- [Quickstart: Use a remote desktop client to connect to a dev box](./quickstart-connect-to-dev-box-with-remote-desktop-app.md)
+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 chrome book, you can use the browser. The browser is useful for tasks such as a quick bug fix, or a pull request (PR) review.
-
-- [Use 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
+
 When you no longer need a dev box, you can delete it.
 
-There are many reasons why you might not need a dev box anymore. Maybe you're finished testing, or you finished working on a specific project within your product. 
+There are many reasons why you might not need a dev box anymore. Maybe you finished testing, or you finished working on a specific project within your product.
 
-You can delete dev boxes once you finish your tasks. Say you finished fixing your bug and merged your pull request. Now, you can delete your dev box and create new dev boxes to work on new items. 
+You can delete dev boxes after you finish your tasks. Say you finished fixing your bug and merged your pull request. Now, you can delete your dev box and create new dev boxes to work on new items.
 
-> [!NOTE] 
-> Ensure that neither you, nor your team members need the dev box before deleting as dev boxes cannot be retrieved after deletion. 
+> [!NOTE]
+> Ensure that neither you nor your team members need the dev box before deleting. You can't retrieve dev boxes after deletion.
 
 [!INCLUDE [clean up resources](./includes/clean-up-resources.md)]  
- 
 
 ## 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)