Learn Editor: Update quickstart-configure-dev-box-service.md

Author: RoseHJM

articles/dev-box/quickstart-configure-dev-box-service.md

@@ -14,7 +14,7 @@ ms.custom: references_regions
 
 # Quickstart: Configure Microsoft Dev Box Preview
 
-This quickstart describes how to configure the Microsoft Dev Box Preview service by using the Azure portal to enable development teams to self-serve dev boxes.
+This quickstart describes how to configure Microsoft Dev Box Preview by using the Azure portal to enable development teams to self-serve their dev boxes.
 
 This quickstart takes you through the process of setting up your Dev Box environment. You create a dev center to organize your dev box resources, configure network components to enable dev boxes to connect to your organizational resources, and create a dev box definition that will form the basis of your dev boxes. You then create a project and a dev box pool, which work together to help you give access to users who will manage or use the dev boxes.
 
@@ -26,8 +26,7 @@ To complete this quickstart, you need:
 
 - An Azure account with an active subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 - Owner or Contributor role on an Azure subscription or a specific resource group.
-- An existing virtual network and subnet. If you don't have them, [follow these instructions to create them](#create-a-virtual-network-and-subnet).
-- Network Contributor permissions on an existing virtual network (Owner or Contributor), or permission to create a new virtual network and subnet.
+- - Network Contributor permissions on an existing virtual network (Owner or Contributor), or permission to create a new virtual network and subnet.
 - User licenses. To use Dev Box Preview, each user must be licensed for Windows 11 Enterprise or Windows 10 Enterprise, Microsoft Intune, and Azure Active Directory (Azure AD) P1. These licenses are available independently and are included in the following subscriptions:
 
   - Microsoft 365 F3
@@ -36,13 +35,8 @@ To complete this quickstart, you need:
   - Microsoft 365 Business Premium
   - Microsoft 365 Education Student Use Benefit
 - [Azure Hybrid Benefit](https://azure.microsoft.com/pricing/hybrid-benefit/), which allows you to use your Windows licenses on Azure with Dev Box.
-- A configured and working Azure AD join or hybrid Active Directory join:
-
-  - To learn how to join devices directly to Azure AD, see [Plan your Azure Active Directory join deployment](../active-directory/devices/azureadjoin-plan.md).
-  - To learn how to join your AD DS domain-joined computers to Azure AD from an on-premises Azure Active Directory Domain Services (AD DS) environment, see [Plan your hybrid Azure Active Directory join deployment](../active-directory/devices/hybrid-azuread-join-plan.md).
-- Certain ports to be open so that the Dev Box service can function, if your organization routes egress traffic through a firewall. For more information, see [Network requirements](/windows-365/enterprise/requirements-network).
-
-## Create a dev center
+- Certain ports to be open so that the Dev Box service can function if your organization routes egress traffic through a firewall. For more information, see [Network requirements](/windows-365/enterprise/requirements-network).
+## 1. Create a dev center
 
 Use the following steps to create a dev center so that you can manage your dev box resources:  
 
@@ -83,7 +77,7 @@ Use the following steps to create a dev center so that you can manage your dev b
 
 1. When the deployment is complete, select **Go to resource**. Confirm that the dev center page appears.
 
-## Create a network connection
+## 2. Create a network connection
 
 Network connections determine the region in which dev boxes are deployed. They also allow dev boxes to be connected to your existing virtual networks. The following steps show you how to create and configure a network connection in Microsoft Dev Box Preview.  
 
@@ -114,13 +108,19 @@ You must have a virtual network and subnet available for your network connection
 
 1. Select **Create**.
 
-### Create the connection
+### Create the network connection
+
+You now need a network connection to associate the virtual network and subnet with the dev center. A network connection specifies the type of join dev boxes use to join your Azure AD domain, either an Azure AD join or a hybrid Active Directory join.
 
-You now need a network connection to associate the virtual network and subnet with the dev center. To create the connection, complete the steps on the relevant tab.
+- To determine which type of join is appropriate for your dev boxes, refer to:
+   
+   - [Azure AD joined devices](https://https://learn.microsoft.com/en-us/azure/active-directory/devices/concept-azure-ad-join).
+   - [Hybrid Azure AD joined devices](https://https://learn.microsoft.com/en-us/azure/active-directory/devices/concept-azure-ad-join-hybrid).
+To create the connection, complete the steps on the relevant tab.
 
 #### [Azure AD join](#tab/AzureADJoin/)
 
-1. Sign in to the [Azure portal](https://portal.azure.com).
+1. 1. 1. Sign in to the [Azure portal](https://portal.azure.com).
 
 1. In the search box, enter **network connections**. In the list of results, select **Network connections**.
 
@@ -181,8 +181,7 @@ You now need a network connection to associate the virtual network and subnet wi
 1. When the deployment is complete, select **Go to resource**. The network connection appears on the **Network connections** page.
 
 ---
-
-## Attach a network connection to a dev center
+## 3. Attach a network connection to a dev center
 
 To provide network configuration information for dev boxes, associate a network connection with a dev center:
 
@@ -192,7 +191,7 @@ To provide network configuration information for dev boxes, associate a network
 
 1. Select the dev center that you created, and then select **Networking**.
 
-1. Select  **+ Add**.
+1. Select **+ Add**.
 
 1. On the **Add network connection** pane, select the network connection that you created, and then select **Add**.
 
@@ -202,7 +201,7 @@ After you attach a network connection, the Azure portal runs several health chec
 
 To resolve any errors, see [Troubleshoot Azure network connections](/windows-365/enterprise/troubleshoot-azure-network-connection).
 
-## Create a dev box definition
+## 4. Create a dev box definition
 
 Dev box definitions define the image and SKU (compute + storage) that will be used in creation of the dev boxes. To create and configure a dev box definition:
 
@@ -226,7 +225,7 @@ Dev box definitions define the image and SKU (compute + storage) that will be us
 
 1. Select **Create**.
 
-## Create a project
+## 5. Create a project
 
 Dev box projects enable you to manage team-level settings. These settings include providing access to development teams so that developers can create dev boxes.
 
@@ -260,7 +259,7 @@ To create and configure a project in a dev box:
 
 1. Verify that the project appears on the **Projects** page.
 
-## Create a dev box pool
+## 6. Create a dev box pool
 
 A dev box pool is a collection of dev boxes that have similar settings. Dev box pools specify the dev box definitions and network connections that dev boxes will use. You must associate at least one pool with your project before users can create a dev box.
 
@@ -301,7 +300,7 @@ The Azure portal deploys the dev box pool and runs health checks to ensure that
 
 :::image type="content" source="./media/quickstart-configure-dev-box-service/dev-box-pool-grid-populated.png" alt-text="Screenshot that shows a list of dev box pools and status information.":::
 
-## Provide access to a dev box project
+## 7. Provide access to a dev box project for developers
 
 Before users can create dev boxes based on the dev box pools in a project, you must provide access for them through a role assignment. The Dev Box User role enables dev box users to create, manage, and delete their own dev boxes. You must have sufficient permissions to a project before you can add users to it.
 
@@ -335,11 +334,11 @@ To assign roles:
 
 [!INCLUDE [supported accounts note](./includes/note-supported-accounts.md)]
 
-## Assign the Project Admin role
+## Project Admins
 
-The Microsoft Dev Box Preview service makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their teams, like creating and managing dev box pools. To give users permissions to manage projects, assign the DevCenter Project Admin role to them.
+Microsoft Dev Box Preview makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their teams, like creating and managing dev box pools. To give users permissions to manage projects, assign the DevCenter Project Admin role to them.
 
-You can assign the DevCenter Project Admin role by using the steps described earlier in [Provide access to a dev box project](#provide-access-to-a-dev-box-project), but select the Project Admin role instead of the Dev Box User role. For more information, see [Provide access to projects for project admins](how-to-project-admin.md).
+You can assign the DevCenter Project Admin role by using the steps described earlier in [Provide access to a dev box ](#provide-access-to-a-dev-box-project)project and select the Project Admin role instead of the Dev Box User role. For more information, see [Provide access to projects for project admins](how-to-project-admin.md).
 
 [!INCLUDE [permissions note](./includes/note-permission-to-create-dev-box.md)]
 
@@ -349,3 +348,4 @@ In this quickstart, you created a dev box project and the resources that are nec
 
 > [!div class="nextstepaction"]
 > [Create a dev box](./quickstart-create-dev-box.md)
+