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

ShawnJackson · ShawnJackson · commit 027e97f3a8ab · 2023-03-09T15:45:33.000-06:00
diff --git a/articles/dev-box/how-to-manage-dev-box-definitions.md b/articles/dev-box/how-to-manage-dev-box-definitions.md
@@ -15,7 +15,7 @@ ms.topic: how-to
 
 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.
 
-Depending on their task, development teams have different software, configuration, compute, and storage size 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.
+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
 
@@ -37,7 +37,7 @@ 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
 
@@ -50,85 +50,83 @@ When you select an image to use in your dev box definition, you must specify if
 
 You can create multiple dev box definitions to meet the needs of your developer teams.
 
-The following steps show you how to create a dev box definition using an existing dev center.
-
-If you don't have an available dev center, follow the steps in [Quickstart: Configure the Microsoft Dev Box service](./quickstart-configure-dev-box-service.md) to create one.
+The following steps show you how to create a dev box definition by using an existing dev center. If you don't have an available dev center, follow the steps in [Quickstart: Configure Microsoft Dev Box](./quickstart-configure-dev-box-service.md) to create one.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
 1. In the search box, enter **dev center**. In the list of results, select **Dev centers**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot showing a search for dev center from the Azure portal search box.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot that shows a search for dev centers from the Azure portal search box.":::
 
-1. Open the dev center in which you want to create the new dev box definition, and then select **Dev box definitions**.
+1. Open the dev center in which you want to create the dev box definition, and then select **Dev box definitions**.
   
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot showing the dev center overview page with Dev box definitions highlighted.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot that shows the dev center overview page and the menu item for dev box definitions.":::
 
-1. On the Dev box definitions page, select **Create**.
+1. On the **Dev box definitions** page, select **Create**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/create-dev-box-definition.png" alt-text="Screenshot of the list of existing dev box definitions with Create highlighted.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/create-dev-box-definition.png" alt-text="Screenshot of the Create button and the list of existing dev box definitions.":::
 
-1. On the Create dev box definition page, enter the following values:
+1. On the **Create dev box definition** pane, enter the following values:
 
    |Name|Value|
    |----|----|
    |**Name**|Enter a descriptive name for your dev box definition. You can't change the dev box definition name after it's created. |
-   |**Image**|Select the base operating system for the dev box. You can select an image from the Marketplace or from an 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 or the **Visual Studio 2022 Pro on Windows 11 Enterprise + Microsoft 365 Apps 22H2**.|
-   |**Image version**|Select a specific, numbered version to ensure all the dev boxes in the pool always use the same version of the image. Select  **Latest** to ensure new dev boxes use the latest image available.|
+   |**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** or **Visual Studio 2022 Pro on Windows 11 Enterprise + Microsoft 365 Apps 22H2** image.|
+   |**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.|
    |**Compute**|Select the compute combination for your dev box definition.|
    |**Storage**|Select the amount of storage for your dev box definition.|
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/recommended-test-image.png" alt-text="Screenshot showing the Create dev box definition page.":::
+   :::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 create the dev box definition, select **Create**.
+1. To finish creating the dev box definition, select **Create**.
 
 ## Update a dev box definition
 
-Over time, your needs for dev boxes will change. You may want to move from a Windows 10 base operating system to a Windows 11 base operating system, or increase the default compute specification for your dev boxes. Your initial dev box definitions may no longer be appropriate for your needs. You can update a dev box definition, so that new dev boxes will use the new configuration.
+Over time, your needs for dev boxes will change. You might want to move from a Windows 10 base operating system to a Windows 11 base operating system, or increase the default compute specification for your dev boxes. Your initial dev box definitions might no longer be appropriate for your needs. You can update a dev box definition so that new dev boxes will use the new configuration.
 
-You can update the image, image version, compute, and storage settings for a dev box definition.
+You can update the image, image version, compute, and storage settings for a dev box definition:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
 1. In the search box, enter **dev center**. In the list of results, select **Dev centers**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot showing a search for devcenter from the Azure portal search box.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot that shows a search for dev centers in the Azure portal search box.":::
 
-1. Open the dev center that contains the dev box definition you want to update, and then select **Dev box definitions**.
+1. Open the dev center that contains the dev box definition that you want to update, and then select **Dev box definitions**.
   
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot showing the dev center overview page with Dev box definitions highlighted.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot that shows the dev center overview page and the menu option for dev box definitions.":::
   
-1. Select the dev box definition(s) you want to update and then select the edit button.
+1. Select the dev box definitions that you want to update, and then select the edit button.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/update-dev-box-definition.png" alt-text="Screenshot of the list of existing dev box definitions, with the edit button highlighted.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/update-dev-box-definition.png" alt-text="Screenshot of the list of existing dev box definitions and the edit button.":::
 
-1. On the Edit *dev box definition name* page, you can select a new image, change the image version, change the compute, or modify the storage available.
+1. On the page for editing a dev box definition, you can select a new image, change the image version, change the compute, or modify the available storage.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/update-dev-box-definition-page.png" alt-text="Screenshot of the edit dev box definition page.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/update-dev-box-definition-page.png" alt-text="Screenshot of the page for editing a dev box definition.":::
 
-1. When you have made your updates, select **Save**.
+1. Select **Save**.
 
 ## Delete a dev box definition
 
-You can delete a dev box definition when you no longer want to use it. Deleting a dev box definition is permanent, and can't be undone. Dev box definitions can't be deleted if they are in use by one or more dev box pools.
+You can delete a dev box definition when you no longer want to use it. Deleting a dev box definition is permanent and can't be undone. Dev box definitions can't be deleted if one or more dev box pools are using them.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **dev center**. In this list of results, select **Dev centers**.
+1. In the search box, enter **dev center**. In the list of results, select **Dev centers**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot showing a search for devcenter from the Azure portal search box.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/discover-devcenter.png" alt-text="Screenshot of a search for dev centers from the Azure portal search box.":::
 
 1. Open the dev center from which you want to delete the dev box definition, and then select **Dev box definitions**.
   
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot showing the dev center overview page with Dev box definitions highlighted.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/select-dev-box-definitions.png" alt-text="Screenshot of the dev center overview page and the menu item for dev box definitions.":::
   
-1. Select the dev box definition you want to delete and then select **Delete**.
+1. Select the dev box definition that you want to delete, and then select **Delete**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-definitions/delete-dev-box-definition.png" alt-text="Screenshot of the list of existing dev box definitions, with the one to be deleted selected.":::
+   :::image type="content" source="./media/how-to-manage-dev-box-definitions/delete-dev-box-definition.png" alt-text="Screenshot of a selected dev box definition and the Delete button.":::
 
 1. In the warning message, select **OK**.
 
-    :::image type="content" source="./media/how-to-manage-dev-box-definitions/delete-warning.png" alt-text="Screenshot of the Delete dev box definition warning message.":::
+    :::image type="content" source="./media/how-to-manage-dev-box-definitions/delete-warning.png" alt-text="Screenshot of the warning message about deleting a dev box definition.":::
 
 ## Next steps
 
diff --git a/articles/dev-box/how-to-manage-dev-boxes.md b/articles/dev-box/how-to-manage-dev-boxes.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,54 +10,50 @@ 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 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 a dev box
+- Create, view, and delete dev boxes that you create.
+- View pools within a project.
+- Connect to dev boxes.
 
-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
 
-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. 
+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.
 
-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. 
+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.
 
 [!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 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).
 
 ## 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
 
diff --git a/articles/dev-box/how-to-project-admin.md b/articles/dev-box/how-to-project-admin.md
@@ -10,7 +10,7 @@ ms.date: 10/12/2022
 ms.topic: how-to
 ---
 
-# Manage Microsoft Dev Box Preview projects
+# Provide access to projects for project admins
 
 You can create multiple Microsoft Dev Box Preview projects in the dev center to align with each team's specific requirements. By using the built-in DevCenter Project Admin role, you can delegate project administration to a member of a team. Project admins can use the network connections and dev box definitions configured at the dev center level to create and manage dev box pools within their project.
 
diff --git a/articles/dev-box/includes/clean-up-resources.md b/articles/dev-box/includes/clean-up-resources.md
@@ -8,8 +8,10 @@ ms.service: dev-box
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
 
-1. For the dev box you want to delete, from the setting menu, select **Delete**.
-   :::image type="content" source="../media/quickstart-create-dev-box/dev-portal-delete-dev-box.png" alt-text="Screenshot of the dev box Settings menu with the Delete option highlighted."::: 
+1. For the dev box that you want to delete, from the **Actions** menu, select **Delete**.
+
+   :::image type="content" source="../media/quickstart-create-dev-box/dev-portal-delete-dev-box.png" alt-text="Screenshot of the dev box Actions menu with the Delete option.":::
 
 1. To confirm the deletion, select **Delete**.
-   :::image type="content" source="../media/quickstart-create-dev-box/dev-portal-delete-dev-box-confirm.png" alt-text="Screenshot of the Delete dev box confirmation message with the Delete button highlighted.":::  
+
+   :::image type="content" source="../media/quickstart-create-dev-box/dev-portal-delete-dev-box-confirm.png" alt-text="Screenshot of the confirmation message about deleting a dev box.":::
diff --git a/articles/dev-box/includes/create-dev-box.md b/articles/dev-box/includes/create-dev-box.md
