Merge pull request #295477 from RoseHJM/mdb-add-developer-portal-updates-quickstart

MDB - update quickstart for Windows App

Author: JillGrant615

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/30/2025
+ms.date: 02/28/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.
@@ -16,15 +16,7 @@ ms.topic: how-to
 
 In this article, you learn how to manage a dev box by using the Microsoft Dev Box developer portal. Developers can access their dev boxes directly in the developer portal, instead of having to use the Azure portal.
 
-As a developer, you can view information about your dev boxes. You can also connect to, start, stop, restart, and delete them.
-
-## Permissions
-
-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.
+The developer portal is your central location to manage all of your dev boxes. In the developer portal, you can view information about your dev boxes. 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 also 
 
 ## Create a dev box
 
@@ -37,19 +29,54 @@ You can create a dev box by using the Microsoft Dev Box developer portal. For mo
 
 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
+## Connect through an app
+
+After you create your dev box, you can connect to it through a Remote Desktop application like Windows App or through the browser.
+
+Windows App is the recommended client for Microsoft Dev Box; it provides an enhanced user experience, including support for multiple monitors. 
+
+If necessary, you can also connect to your dev box by using the legacy Remote Desktop client.
+
+### Connect through the Windows App
+
+Windows App is the default app for connecting to your dev box. You can use the Windows App to connect to your dev box from any device, including your phone or laptop. The Windows App is available on multiple platforms, including Windows, macOS, iOS/iPadOS, Android/Chrome OS (preview), and web browsers.
+
+[!INCLUDE [connect-with-windows-app](includes/connect-with-windows-app.md)]  
+
+### Connect through the legacy Remote Desktop client
+
+If you prefer to use the legacy Remote Desktop client, you can do so. You set the app you want to use to connect through the user settings in the developer portal:
 
-After you create your dev box, you can connect to it through a Remote Desktop application or via the browser.
+1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
+ 
+1. Select the user settings icon in the top right corner.
+ 
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-user-settings-icon.png" alt-text="Screenshot of the developer portal, with the user settings icon in the top right corner highlighted.":::
+
+1. In **User settings**, select **Connect via Remote Desktop (legacy)**.
+ 
+   :::image type="content" source="media/how-to-create-dev-boxes-developer-portal/dev-box-user-settings-remote-desktop.png" alt-text="Screenshot of the dev box user settings, showing the option for using the legacy remote desktop app.":::
+
+1. Close **User settings**.
+
+### Connect through the browser
+
+You can use a browser like Microsoft Edge 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).
+
+To connect to a dev box by using the browser:
+1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
 
-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).
+1. Select **Open in browser**.
+   
+:::image type="content" source="./media/how-to-create-dev-boxes-developer-portal/dev-portal-open-in-browser.png" alt-text="Screenshot of dev box card that shows the option for opening in a browser." lightbox="./media/how-to-create-dev-boxes-developer-portal/dev-portal-open-in-browser.png":::
 
-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).
+A new tab opens with a new session through which you can use your dev box. Use a work or school account to sign in to your dev box, not a personal Microsoft account.
 
-## Explore dev box actions
+## Configure multiple monitors
 
-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.
+[!INCLUDE [configure-multiple-monitors](includes/configure-multiple-monitors.md)]
 
-### Shut down, restart, or start a dev box
+## Shut down, restart, or start a dev box
 
 To shut down or restart a dev box:
 
@@ -71,7 +98,7 @@ To start a dev box:
 
 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.
 
@@ -96,7 +123,7 @@ 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 you and your team members don't need the dev box for future tasks. 
+> You can't retrieve a dev box after deletion. 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).
 
@@ -118,4 +145,4 @@ Dependent on how your dev box is configured, you can perform more actions on a d
 
 ## Related content
 
-- [Use a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box)
+- [Use a browser to connect to a dev box](./quickstart-create-dev-box.md#connect-to-a-dev-box)

articles/dev-box/includes/configure-multiple-monitors.md

@@ -0,0 +1,23 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 03/03/2025
+ms.topic: include
+ms.service: dev-box
+---
+
+You can configure multiple monitors for your dev box. This is useful when you want to work on multiple tasks at the same time, such as debugging and writing code. You can also use multiple monitors to view different applications side by side.
+
+You enable or disable multiple monitors through the user settings in the developer portal:
+
+1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
+
+1. Select the user settings icon in the top right corner.
+ 
+   :::image type="content" source="../media/configure-multiple-monitors/dev-box-user-settings-icon.png" alt-text="Screenshot of the developer portal, showing the user settings icon in the top right corner.":::
+
+1. In **User settings**, select **Use multiple monitors**.
+ 
+   :::image type="content" source="../media/configure-multiple-monitors/dev-box-user-settings-multiple-monitors.png" alt-text="Screenshot of the dev box user settings, showing the option for using multiple monitors.":::
+
+1. Close **User settings**.

articles/dev-box/includes/connect-with-windows-app.md

@@ -0,0 +1,17 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 03/03/2025
+ms.topic: include
+ms.service: dev-box
+---
+
+To connect to a dev box by using the Windows App:
+
+1. Install Windows App on your device. [Download Windows App](https://aka.ms/devbox-windows-app).
+ 
+1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
+
+1. Select **Connect via app**.
+ 
+   :::image type="content" source="../media/connect-with-windows-app/dev-box-connect-via-app.png" alt-text="Screenshot of dev box tile, showing the Connect via app option.":::

articles/dev-box/includes/developer-portal-landing-page.md

@@ -1,7 +1,7 @@
 ---
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 11/13/2024
+ms.date: 03/05/2025
 ms.topic: include
 ms.service: dev-box
 ---
@@ -31,7 +31,7 @@ ms.service: dev-box
 
 #### [Existing dev boxes](#tab/existing-dev-boxes)
 
-3. Select **New** > **New dev box**.
+3. If you have existing dev boxes, you see this screen. Select **New** > **New dev box**.
 
    :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-menu.png" alt-text="Screenshot of the developer portal with the New menu and Dev box option highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-menu.png":::