MDB - dev portal updates 002

Author: RoseHJM

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: 01/03/2024
+ms.date: 01/30/2025
 ms.topic: how-to
 
 # customer intent: As a developer, I want to learn what tasks I can perform through the developer portal so that I can manage my dev boxes.
@@ -41,19 +41,21 @@ You can also create a dev box through the Azure CLI dev center extension. For mo
 
 After you create your dev box, you can connect to it through a Remote Desktop application or via the browser.
 
-The new Windows App remote desktop client is the recommended client for Microsoft Dev Box; it provides an enhanced user experience, including support for multiple monitors. It is also available on multiple platforms, including Windows, macOS, iOS/iPadOS, Android/Chrome OS (preview), and web browsers. For more information, see [Get started with Windows App](https://aka.ms/dev-box/windows-app).
+The new Windows App remote desktop client is the recommended client for Microsoft Dev Box; it provides an enhanced user experience, including support for multiple monitors. It's also available on multiple platforms, including Windows, macOS, iOS/iPadOS, Android/Chrome OS (preview), and web browsers. For more information, see [Get started with Windows App](https://aka.ms/dev-box/windows-app).
 
 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).
 
-## Shut down, restart, or start a dev box
+## Explore dev box actions
 
-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.
+
+### Shut down, restart, or start 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 that want to shut down or restart, select the actions menu (**...**).
+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 the developer portal showing the actions menu for a running dev box." border="false"::: 
 
@@ -63,29 +65,29 @@ To start a dev box:
 
 1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
 
-1. On the dev box you that want to start, select the actions menu (**...**).
+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 the developer portal showing the actions menu for a stopped dev box." border="false"::: 
 
 1. For a stopped dev box, you can select **Start**.
 
-## Get information about a dev box
+### Get information about a dev box
 
 You can use the Microsoft Dev Box developer portal to view information about a dev box, such as the creation date, and the dev center and dev box pool it belongs to. You can also check the source image in use.
 
 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 that you want to view, select the actions menu (**...**) and then select **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 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." border="false":::
 
-## Delete a dev box
+### Delete a dev box
 
 When you no longer need a dev box, you can delete it in the developer portal.
 
@@ -94,18 +96,26 @@ There are many reasons why you might not need a dev box anymore. Maybe you compl
 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.
 
 > [!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. 
+> You can't retrieve a dev box after it's deleted. Before you delete a dev box, confirm that you and your team members don't 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 the actions menu (**...**) and then select **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 developer portal showing the actions menu for a dev box and Delete selected." border="false":::
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-actions-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 after you select to delete a dev box." border="false":::
 
+### Discover more dev box actions
+
+Dependent on how your dev box is configured, you can perform more actions on a dev box in the Microsoft Dev Box developer portal. For example, you can:
+
+**Hibernate or resume:**If your dev box has hibernation enabled, you can hibernate or resume the dev box. Hibernation is useful when you want to save the current state of your dev box and resume it later. For more information, see [Hibernate a dev box in Microsoft Dev Box](how-to-hibernate-your-dev-box.md).
+
+**Troubleshoot & repair:**If you encounter issues connecting to your dev box, you can use the Troubleshoot and repair to relsove the issue. For more information, see [Troubleshoot and repair a dev box in Microsoft Dev Box](how-to-troubleshoot-repair-dev-box.md).
+
 ## Related content
 
 - [Use a remote desktop client to connect to a dev box](./tutorial-connect-to-dev-box-with-remote-desktop-app.md)