MDB - quickstart create a dev box updates

Author: RoseHJM

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

@@ -10,19 +10,10 @@ ms.service: dev-box
 
    :::image type="content" source="../media/developer-portal-landing-page/developer-portal-landing-page-sign-in.png" alt-text="Screenshot of the developer portal landing page with sign-in highlighted.":::
 
-2. The first time you visit the developer portal, you're welcomed with a short tour. Select **Continue** to learn about the developer portal.
+2. The first time you visit the developer portal, you're welcomed with a short tour. Select **Continue** to learn about the developer portal, or select **Skip** to go straight to the portal.
 
    :::image type="content" source="../media/developer-portal-landing-page/developer-portal-welcome-tour.png" alt-text="Screenshot of the welcome tour in the developer portal.":::
 
-   Follow the tips to learn about the developer portal.
-
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-welcome-tip-1.png" alt-text="Screenshot of the developer portal showing the first welcome tour tip.":::
-
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-welcome-tip-2.png" alt-text="Screenshot of the developer portal showing the second welcome tour tip.":::
-
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-welcome-tip-3.png" alt-text="Screenshot of the developer portal showing the third welcome tour tip.":::
-   
-
 #### [No existing dev boxes](#tab/no-existing-dev-boxes)
 
 3. If you don't have any dev boxes, you see this screen. Select **New dev box**.

articles/dev-box/media/developer-portal-landing-page/developer-portal-welcome-tip-1.png

@@ -1,46 +1,48 @@
 ---
-title: 'Quickstart: Create a dev box'
+title: 'Quickstart: Create and Access a Dev Box in the Cloud'
 titleSuffix: Microsoft Dev Box
-description: In this quickstart, learn how developers can create a dev box in the Microsoft Dev Box developer portal, and remotely connect to it through the browser.
+description: 'Set up your cloud dev environment: Create a dev box in Microsoft Dev Box and connect remotely. Get started quickly and work on projects from any device.'
 services: dev-box
 ms.service: dev-box
 ms.custom:
   - build-2024
+  - ai-gen-docs-bap
+  - ai-gen-title
+  - ai-seo-date:05/28/2025
+  - ai-gen-description
 ms.topic: quickstart
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 03/03/2025
-#Customer intent: As a dev box user, I want to understand how to create and access a dev box so that I can start work.
+ms.date: 05/28/2025
 ---
 
 # Quickstart: Create and connect to a dev box by using the Microsoft Dev Box developer portal
 
 [!INCLUDE [note-build-2025](includes/note-build-2025.md)]
 
+Microsoft Dev Box provides cloud-based developer workstations that you can create and manage on demand. This quickstart shows you how to create a dev box in the Microsoft Dev Box developer portal and connect to it remotely. Follow these steps to quickly set up your cloud development environment and start working on your projects from anywhere.
 
-In this quickstart, you get started with Microsoft Dev Box by creating a dev box through the developer portal. After you create the dev box, you can connect to it through a browser or through a Remote Desktop client like Windows App.
-
-You can create and manage multiple dev boxes as a dev box user. Create a dev box for each task that you're working on, and create multiple dev boxes within a single project to help streamline your workflow. For example, you might switch to another dev box to fix a bug in a previous version, or if you need to work on a different part of the application.
+Create and manage multiple dev boxes as a dev box user. Create a dev box for each task you're working on, and create multiple dev boxes in a single project to streamline your workflow. For example, switch to another dev box to fix a bug in a previous version, or to work on a different part of the application.
 
 ## Prerequisites
 
 To complete this quickstart, you need:
 
 | Product | Requirements |
 |---------|--------------|
-| Microsoft Dev Box | Your organization must configure Microsoft Dev Box with at least one project and dev box pool before you can create a dev box. <br> - Platform engineers can follow these steps to configure Microsoft Dev Box: [Quickstart: Configure Microsoft Dev Box](quickstart-configure-dev-box-service.md). <br>**Permissions** <br> - You must have permissions as a [Dev Box User](quickstart-configure-dev-box-service.md#provide-access-to-a-dev-box-project) for a project that has an available dev box pool. If you don't have permissions to a project, contact your administrator.|
-| Windows App | To connect to a dev box by using the Windows App, you need to install the Windows App on your device. <br> - [Download Windows App](https://apps.microsoft.com/detail/9n1f85v9t8bn?hl=en-us&gl=US) |
+| Microsoft Dev Box | Your organization needs to set up Microsoft Dev Box with at least one project and dev box pool before you create a dev box. <br> - Platform engineers can follow these steps to set up Microsoft Dev Box: [Quickstart: Configure Microsoft Dev Box](quickstart-configure-dev-box-service.md). <br>**Permissions** <br> - You need permissions as a [Dev Box User](quickstart-configure-dev-box-service.md#provide-access-to-a-dev-box-project) for a project that has an available dev box pool. If you don't have permissions to a project, contact your admin.|
+| Windows App | To connect to a dev box with the Windows App, install the Windows App on your device. <br> - [Download Windows App](https://apps.microsoft.com/detail/9n1f85v9t8bn?hl=en-us&gl=US) |
 
 ## Create a dev box
 
 Microsoft Dev Box enables you to create cloud-hosted developer workstations in a self-service way. You can create and manage dev boxes by using the developer portal.
 
-Depending on the project configuration and your permissions, you have access to different projects and associated dev box configurations. If you have a choice of projects and dev box pools, select the project and dev box pool that best fits your needs. For example, you might choose a project that has a dev box pool located near to you for least latency.
+Depending on the project configuration and your permissions, you might have access to different projects and associated dev box configurations. If you have a choice of projects, images, and regions, select the resources that best fits your needs. For example, you might choose a region located near to you for the least latency.
 
 > [!IMPORTANT]
 > Your organization must configure Microsoft Dev Box with at least one project and dev box pool before you can create a dev box. If you don't see any projects or dev box pools, contact your administrator.
 
-To create a dev box in the Microsoft Dev Box developer portal:
+Create a dev box in the Microsoft Dev Box developer portal:
 
 [!INCLUDE [developer-portal-landing-page](includes/developer-portal-landing-page.md)]
 
@@ -49,33 +51,34 @@ To create a dev box in the Microsoft Dev Box developer portal:
    | Setting | Value |
    |---|---|
    | **Name** | Enter a name for your dev box. Dev box names must be unique within a project. |
-   | **Project** | Select a project from the dropdown list. |
-   | **Dev box pool** | Select a pool from the dropdown list, which includes all the dev box pools for that project. Choose a dev box pool near to you for least latency.|
+   | **Project** | If available, select a project from the list. |
+   | **Image** | If available, select an image from the list. Choose an image that contains the tools and code needed for your development tasks.|
+   | **Region** | If available, select a region for your dev box. Choose a region close to you for least latency. |
 
-   :::image type="content" source="./media/quickstart-create-dev-box/developer-portal-create-dev-box.png" alt-text="Screenshot of the dialog for adding a dev box." lightbox="./media/quickstart-create-dev-box/developer-portal-create-dev-box.png":::
+   :::image type="content" source="./media/quickstart-create-dev-box/developer-portal-create-dev-box.png" alt-text="Screenshot of the dialog for adding a dev box in the developer portal." lightbox="./media/quickstart-create-dev-box/developer-portal-create-dev-box.png":::
 
-   After you make your selections, the page shows you the following information:
+      After you make your selections, the page shows the following information:
 
-   - How many dev boxes you can create in the project that you selected, if the project has limits configured.
-   - Whether *Hibernation* is supported or not.
-   - Whether *Customizations* is enabled or not.
-   - A shutdown time if the pool where you're creating the dev box has a shutdown schedule.
+   - How many dev boxes you can create in the selected project, if the project has limits set.
+   - Whether *Hibernation* is supported.
+   - Whether you can apply *Customizations*.
+   - The shutdown time if the pool where you're creating the dev box has a shutdown schedule.
    - A notification that the dev box creation process can take 25 minutes or longer.
 
-5. Select **Create** to begin creating your dev box.
+5. Select **Create** to start creating your dev box.
 
-6. Track the progress of creation by using the dev box tile in the developer portal. The status changes from *Creating* to *Running* when the dev box is ready for you to connect to it.
+6. Track the creation progress by using the dev box tile in the developer portal. The status changes from *Creating* to *Running* when the dev box is ready for you to connect.
 
-   :::image type="content" source="./media/quickstart-create-dev-box/dev-box-tile-creating.png" alt-text="Screenshot of the developer portal that shows the dev box card with a status of Creating." lightbox="./media/quickstart-create-dev-box/dev-box-tile-creating.png":::
+   :::image type="content" source="./media/quickstart-create-dev-box/dev-box-tile-creating.png" alt-text="Screenshot of the developer portal showing the dev box card with a status of Creating." lightbox="./media/quickstart-create-dev-box/dev-box-tile-creating.png":::
 
-   > [!Note]
-   > If you encounter a vCPU quota error with a *QuotaExceeded* message, ask your administrator to [request an increased quota limit](/azure/dev-box/how-to-request-quota-increase). If your admin can't increase the quota limit at this time, try selecting another pool with a region close to your location. 
+      > [!Note]
+   > If you get a vCPU quota error with a *QuotaExceeded* message, ask your admin to [request an increased quota limit](/azure/dev-box/how-to-request-quota-increase). If your admin can't increase the quota limit now, try selecting another pool with a region close to your location. 
 
 [!INCLUDE [dev box runs on creation note](./includes/note-dev-box-runs-on-creation.md)]
 
 ## Connect to a dev box
 
-After you create a dev box, you can connect to it remotely through the developer portal on your desktop, laptop, tablet, or phone. Microsoft Edge gives you the best experience. The developer portal provides the option to connect by using Windows App. 
+After you create a dev box, connect to it remotely through the developer portal on your desktop, laptop, tablet, or phone. Microsoft Edge gives you the best experience. The developer portal lets you connect by using Windows App.
 
 ### Connect by using Windows App
 
@@ -89,7 +92,7 @@ After you create a dev box, you can connect to it remotely through the developer
 
 In this quickstart, you created a dev box through the developer portal and connected to it by using a browser. 
 
-When you no longer need your dev box, you can delete it:
+When you no longer need your dev box, delete it:
 
 [!INCLUDE [dev box runs on creation note](./includes/clean-up-resources.md)]