Merge pull request #262241 from GitHubber17/183368-11

Freshness | Microsoft Dev Box procedures

Author: v-dirichards

articles/dev-box/how-to-create-dev-boxes-developer-portal.md

@@ -6,7 +6,7 @@ services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 09/11/2023
+ms.date: 01/03/2024
 ms.topic: how-to
 ---
 
@@ -28,43 +28,44 @@ As a dev box developer, you can:
 
 You can create as many dev boxes as you need through the Microsoft Dev Box developer portal. You might create a separate dev box for different scenarios, for example:
 
-- **Dev box per 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.
-- **Dev box for bug fixing**: you could use a separate dev box for the bug fix to work on the specific task and troubleshoot the issue without impacting your primary machine.
+- **Dev box per workload**. Create a dev box for your front-end work and a separate dev box for your back-end work. You can also create multiple dev boxes for your back-end system.
+- **Dev box for bug fixing**. Use a separate dev box for the bug fix to work on the specific task and troubleshoot the issue without impacting your primary machine.
 
-You can create a dev box by using:
+You can create a dev box by using the Microsoft Dev Box developer portal. For more information, see [Quickstart: Create a dev box by using the developer portal](quickstart-create-dev-box.md). 
 
-- Developer portal. For more information, see [Quickstart: Create a dev box by using the developer portal](quickstart-create-dev-box.md)
-- Azure CLI dev center extension. For more information, see [Configure Microsoft Dev Box from the command-line with the Azure CLI](how-to-install-dev-box-cli.md)
+You can also create a dev box through the Azure CLI dev center extension. For more information, see [Configure Microsoft Dev Box from the command-line with the Azure CLI](how-to-install-dev-box-cli.md).
 
 ## Connect to a dev box
 
-After you create your dev box, you can connect to it in two ways:
+After you create your dev box, you can connect to it through a remote application or via the browser.
 
-- **Remote desktop client application**: remote desktop provides the highest performance and best user experience for heavy workloads. Remote Desktop also supports multi-monitor configuration. For more information, see [Tutorial: Use a Remote Desktop client to connect to a dev box](./tutorial-connect-to-dev-box-with-remote-desktop-app.md).
+A **Remote Desktop client application** provides the highest performance and best user experience for heavy workloads. Remote Desktop also supports multi-monitor configuration. For more information, see [Tutorial: Use a Remote Desktop client to connect to a dev box](./tutorial-connect-to-dev-box-with-remote-desktop-app.md).
 
-- **Browser**: 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).
+You can 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).
 
-## Shutdown, restart or start a dev box
+## Shut down, restart, or start a dev box
 
-You can perform many actions on a dev box in the Microsoft Dev Box developer portal by using the actions menu on the dev box tile. The available options depend on the state of the dev box and the configuration of the dev box pool it belongs to. For example, you can shut down or restart a running dev box, or start a stopped dev box.
+You can perform many actions on a dev box in the Microsoft Dev Box developer portal by using the actions menu (**...**) on the dev box tile. The available options depend on the state of the dev box and the configuration of the dev box pool it belongs to. For example, you can shut down or restart a running dev box, or start a stopped dev box.
 
-To shut down or restart a dev box.
+To shut down or restart a dev box:
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
-1. On the dev box you want to shut down or restart, select actions.
+
+1. On the dev box you that want to shut down or restart, select the actions menu (**...**).
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-shutdown.png" alt-text="Screenshot of developer portal showing the dev box tile for a running dev box with the actions menu highlighted."::: 
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-shutdown.png" alt-text="Screenshot of the developer portal showing the actions menu for a running dev box." border="false"::: 
 
-1. For a dev box that is running, you can select **Shut down** or **Restart**.
+1. For a running dev box, you can select **Shut down** or **Restart**.
 
 To start a dev box:
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
-1. On the dev box you want to start, select actions.
+
+1. On the dev box you that want to start, select the actions menu (**...**).
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-start.png" alt-text="Screenshot of developer portal showing the dev box tile for a stopped dev box with the actions menu highlighted."::: 
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-start.png" alt-text="Screenshot of the developer portal showing the actions menu for a stopped dev box." border="false"::: 
 
-1. For a dev box that is stopped, you can select **Start**.
+1. For a stopped dev box, you can select **Start**.
 
 ## Get information about a dev box
 
@@ -73,34 +74,35 @@ You can use the Microsoft Dev Box developer portal to view information about a d
 To get more information about your dev box:
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
-1. On the dev box you want to view, select actions > **More info**.
+
+1. On the dev box that you want to view, select the actions menu (**...**) and then select **More Info**.
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-more-info.png" alt-text="Screenshot of developer portal showing a dev box tile with the actions menu selected, and more info highlighted.":::
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-more-info.png" alt-text="Screenshot of the developer portal showing the actions menu for a dev box and More Info selected." border="false":::
 
 1. In the dev box details pane, you see more information about your dev box, like the following example:
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-details-pane.png" alt-text="Screenshot of the dev box more information pane, showing creation date, dev center, dev box pool, and source image for the dev box.":::
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-details-pane.png" alt-text="Screenshot of the dev box more information pane, showing creation date, dev center, dev box pool, and source image for the dev box." border="false":::
 
 ## Delete a dev box
 
 When you no longer need a dev box, you can delete it in the developer portal.
 
-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.
+There are many reasons why you might not need a dev box anymore. Maybe you completed your testing, or you finished working on a specific project within your product.
 
-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.
+You can delete dev boxes after you finish your tasks. Suppose you finish fixing your bug and merge 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. You can't retrieve dev boxes after deletion.
+> [!IMPORTANT]
+> You can't retrieve a dev box after it's deleted. Before you delete a dev box, confirm that neither you nor your team members need the dev box for future tasks. 
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
 
-1. For the dev box that you want to delete, select actions > **Delete**.
+1. For the dev box that you want to delete, select the actions menu (**...**) and then select **Delete**.
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-delete.png" alt-text="Screenshot of the dev box actions menu with the Delete option.":::
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-delete.png" alt-text="Screenshot of the developer portal showing the actions menu for a dev box and Delete selected." border="false":::
 
 1. To confirm the deletion, select **Delete**.
 
-   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-confirm-delete.png" alt-text="Screenshot of the confirmation message about deleting a dev box.":::
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-confirm-delete.png" alt-text="Screenshot of the confirmation message after you select to delete a dev box." border="false":::
 
 ## Related content
 

articles/dev-box/media/how-to-create-dev-boxes-developer-portal/dev-box-actions-more-info.png

@@ -68,7 +68,7 @@ There are a few basic troubleshooting steps you can try if you're having issues
 
 1. Make sure you're connected to the internet.
 
-1. Make sure your dev box is running. For more information, see [Shutdown, restart or start a dev box](../dev-box/how-to-create-dev-boxes-developer-portal.md#shutdown-restart-or-start-a-dev-box).
+1. Make sure your dev box is running. For more information, see [Shutdown, restart or start a dev box](../dev-box/how-to-create-dev-boxes-developer-portal.md#shut-down-restart-or-start-a-dev-box).
 
 1. Try to connect to your dev box from the Dev Box developer portal. For more information, see [Connect to a dev box](../dev-box/quickstart-create-dev-box.md#connect-to-a-dev-box).