Merge pull request #290506 from RoseHJM/mdb-developer-portal-welcome

MDB - developer portal landing page

Author: denrea

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

@@ -0,0 +1,25 @@
+---
+author: RoseHJM
+ms.author: rosemalcolm
+ms.date: 11/13/2024
+ms.topic: include
+ms.service: dev-box
+---
+
+1. Go to the [developer portal](https://aka.ms/devbox-portal). The landing page contains useful information and links. When you're ready, select **Sign in**. 
+
+   :::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.":::
+
+#### [No existing dev boxes](#tab/no-existing-dev-boxes)
+
+1. If you don't have any dev boxes, you see this screen. Select **New dev box**.
+
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-dev-box.png" alt-text="Screenshot of the developer portal with new dev box highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-dev-box.png":::
+
+#### [Existing dev boxes](#tab/existing-dev-boxes)
+
+1. 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":::
+ 
+---

articles/dev-box/media/developer-portal-landing-page/developer-portal-landing-page-sign-in.png

@@ -39,11 +39,9 @@ Depending on the project configuration and your permissions, you have access to
 
 To create a dev box in the Microsoft Dev Box developer portal:
 
-1. Sign in to the [Microsoft Dev Box developer portal](https://aka.ms/devbox-portal).
+[!INCLUDE [developer-portal-landing-page](includes/developer-portal-landing-page.md)]
 
-1. Select **New** > **New dev box**.
-
-1. In **Add a dev box**, enter the following values:
+2. In **Add a dev box**, enter the following values:
 
    | Setting | Value |
    |---|---|
@@ -61,9 +59,9 @@ To create a dev box in the Microsoft Dev Box developer portal:
    - A 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.
 
-1. Select **Create** to begin creating your dev box.
+3. Select **Create** to begin creating your dev box.
 
-1. Use the dev box tile in the developer portal to track the progress of creation.
+4. Use the dev box tile in the developer portal to track the progress of creation.
 
    :::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":::