edit pass: microsoft-dev-box-docset-how-to

ShawnJackson · ShawnJackson · commit 6cbd10e98927 · 2023-03-07T18:27:55.000-06:00
diff --git a/articles/dev-box/how-to-manage-dev-center.md b/articles/dev-box/how-to-manage-dev-center.md
@@ -33,7 +33,7 @@ To create a dev center:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev centers**. In the search results, select **Dev centers** from the **Services** list.
+1. In the search box, enter **dev centers**. In the search results, select **Dev centers** from the **Services** list.
 
    :::image type="content" source="./media/how-to-manage-dev-center/search-dev-center.png" alt-text="Screenshot that shows the search box and list of services on the Azure portal.":::
 
@@ -79,13 +79,13 @@ When you're ready to delete your dev center, follow these steps:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev centers**. In the search results, select **Dev centers** from the **Services** list.
+1. In the search box, enter **dev centers**. In the search results, select **Dev centers** from the **Services** list.
 
-1. On the **Dev centers** page, open the dev center you want to delete.
+1. On the **Dev centers** page, open the dev center that you want to delete.
 
 1. Select **Delete**.
 
-    :::image type="content" source="./media/how-to-manage-dev-center/delete-dev-center.png" alt-text="Screenshot of the Delete button on a page for a dev center.":::
+    :::image type="content" source="./media/how-to-manage-dev-center/delete-dev-center.png" alt-text="Screenshot of the Delete button on the page for a dev center.":::
 
 1. In the confirmation message, select **OK**.
 
@@ -95,7 +95,7 @@ You can attach existing network connections to a dev center. You must attach a n
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev centers**. In the list of results, select **Dev centers**.
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
 
 1. Select the dev center that you want to attach the network connection to, and then select **Networking**.
 
@@ -109,7 +109,7 @@ You can remove network connections from dev centers. Network connections can't b
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev centers**. In the list of results, select **Dev centers**.
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
 
 1. Select the dev center that you want to detach the network connection from, and then select **Networking**.
 
@@ -131,7 +131,7 @@ To make role assignments:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, enter **Dev centers**. In the list of results, select **Dev centers**.
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
 
 1. Select the dev center that you want to give access to.
 
@@ -145,7 +145,7 @@ To make role assignments:
     | --- | --- |
     | **Role** | Select **Owner**, **Contributor**, or **Reader**. |
     | **Assign access to** | Select **User, group, or service principal**. |
-    | **Members** | Select the users or groups you want to have access to the dev center. |
+    | **Members** | Select the users or groups that you want to be able to access the dev center. |
 
 ## Next steps
 
diff --git a/articles/dev-box/how-to-manage-network-connection.md b/articles/dev-box/how-to-manage-network-connection.md
@@ -1,43 +1,48 @@
 ---
-title: How to manage network connections
+title: Manage network connections
 titleSuffix: Microsoft Dev Box Preview
-description: This article describes how to create, delete, attach and remove Microsoft Dev Box Preview network connections.
+description: This article describes how to create, delete, attach, and remove Microsoft Dev Box Preview network connections.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
 ms.date: 10/12/2022
 ms.topic: how-to
+#Customer intent: As a dev infrastructure manager, I want to be able to manage network connections so that I can enable dev boxes to connect to my existing networks and deploy them in the desired region.
 ---
 
-<!-- Intent: As a dev infrastructure manager, I want to be able to manage network connections so that I can enable dev boxes to connect to my existing networks and deploy them in the desired region. -->
 # Manage network connections
-Network connections allow dev boxes to connect to existing virtual networks, and determine the region into which dev boxes are deployed. 
-
-When planning network connectivity for your dev boxes, you must:
-- Ensure you have sufficient permissions to create and configure network connections.
-- Ensure you have at least one virtual network (VNet) and subnet available for your dev boxes.
-- Identify the region or location closest to your dev boxes users. Deploying dev boxes into a region close to the users provides them with a better experience.
-- Determine whether dev boxes should connect to your existing networks using an Azure Active Directory (Azure AD) join, or a Hybrid Azure AD join.
-## Permissions 
+
+Network connections allow dev boxes to connect to existing virtual networks. They also determine the region into which dev boxes are deployed.
+
+When you're planning network connectivity for your dev boxes, you must:
+
+- Ensure that you have sufficient permissions to create and configure network connections.
+- Ensure that you have at least one virtual network and subnet available for your dev boxes.
+- Identify the region or location that's closest to your dev box users. Deploying dev boxes into a region thats' close to the users gives them a better experience.
+- Determine whether dev boxes should connect to your existing networks by using Azure Active Directory (Azure AD) join or hybrid Azure AD join.
+
+## Permissions
+
 To manage a network connection, you need the following permissions:
 
 |Action|Permission required|
 |-----|-----|
-|Create and configure VNet and subnet|Network Contributor permissions on an existing virtual network (owner or contributor) or permission to create a new virtual network and subnet.|
-|Create or delete network connection|Owner or Contributor permissions on an Azure Subscription or a specific resource group.|
-|Add or remove network connection |Write permission on the dev center.|
+|Create and configure 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.|
+|Create or delete a network connection|Owner or Contributor permissions on an Azure subscription or a specific resource group.|
+|Add or remove a network connection |Write permission on the dev center.|
 
 ## Create a virtual network and subnet
-To create a network connection, you need an existing VNet and subnet. If you don't have a VNet and subnet available, use the following steps to create them:
+
+To create a network connection, you need an existing virtual network and subnet. If you don't have a virtual network and subnet available, use the following steps to create them:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
- 
-1. In the search box, enter *Virtual Network*, and then select **Virtual Network** from the search results.
 
-1. On the Virtual Network page, select **Create**.
+1. In the search box, enter **virtual network**. In the list of results, select **Virtual Network**.
+
+1. On the **Virtual Network** page, select **Create**.
 
-1. On the Create virtual network page, enter or select this information on the **Basics** tab:
+1. On the **Create virtual network** page, enter or select this information on the **Basics** tab:
 
     | Setting | Value |
     | ------- | ----- |
@@ -59,37 +64,43 @@ To create a network connection, you need an existing VNet and subnet. If you don
 
 1. Select **Create**.
 
- 
 ## Allow access to Dev Box endpoints from your network
+
 Network ingress and egress can be controlled using a firewall, network security groups, and even Microsoft Defender. 
 
 If your organization routes egress traffic through a firewall, you need to open certain ports to allow the Dev Box service to function. For more information, see [Network requirements](/windows-365/enterprise/requirements-network).
 
 ## Plan a network connection
-The following steps show you how to create and configure a network connection in Microsoft Dev Box Preview.  
+
+The following steps show you how to create and configure a network connection in Microsoft Dev Box Preview.
+  
 ### Types of Azure Active Directory Join
-The Dev Box service requires a configured and working Azure AD join or Hybrid AD join, which defines how dev boxes join your domain and access resources. 
+
+The Dev Box service requires a configured and working Azure AD join or hybrid AD join, which defines how dev boxes join your domain and access resources.
 
 If your organization uses Azure AD, you can use an Azure AD join, sometimes called a native Azure AD join. Dev box users sign into Azure AD joined dev boxes using their Azure AD account and access resources based on the permissions assigned to that account. Azure AD join enables access to cloud-based and on-premises apps and resources.
 
-If your organization has an on-premises Active Directory implementation, you can still benefit from some of the functionality provided by Azure AD by using hybrid Azure AD joined dev boxes. These dev boxes are joined to your on-premises Active Directory and registered with Azure Active Directory. Hybrid Azure AD joined dev boxes require network line of sight to your on-premises domain controllers periodically. Without this connection, devices become unusable. 
+If your organization has an on-premises Active Directory implementation, you can still benefit from some of the functionality provided by Azure AD by using hybrid Azure AD joined dev boxes. These dev boxes are joined to your on-premises Active Directory and registered with Azure Active Directory. Hybrid Azure AD joined dev boxes require network line of sight to your on-premises domain controllers periodically. Without this connection, devices become unusable.
 
-You can learn more about each type of join and how to plan for them here:  
--	[Plan your hybrid Azure Active Directory join deployment](../active-directory/devices/hybrid-azuread-join-plan.md)
--	[Plan your Azure Active Directory join deployment](../active-directory/devices/azureadjoin-plan.md)
+To learn more about each type of join and how to plan for them, see:
+  
+- [Plan your hybrid Azure Active Directory join deployment](../active-directory/devices/hybrid-azuread-join-plan.md)
+- [Plan your Azure Active Directory join deployment](../active-directory/devices/azureadjoin-plan.md)
 
 ### Create a network connection
+
+Follow the steps on the relevant tab to create your network connection.
+
+#### [**Azure AD join**](#tab/AzureADJoin/)
+
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-1. In the search box, type *Network connections* and then select **Network connections** from the list.
+1. In the search box, enter **network connections**. In the list of results, **Network connections**.
 
 1. On the **Network Connections** page, select **+Create**.
-     :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot showing the Network Connections page with Create highlighted.":::
+   :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot showing the Network Connections page with Create highlighted.":::
 
-1. Follow the steps on the appropriate tab to create your network connection.
-   #### [**Azure AD join**](#tab/AzureADJoin/)
-
-   On the **Create a network connection** page, on the **Basics** tab, enter the following values:
+1. On the **Create a network connection** page, on the **Basics** tab, enter the following values:
 
    |Name|Value|
    |----|----|
@@ -100,11 +111,24 @@ You can learn more about each type of join and how to plan for them here:
    |**Virtual network**|Select the virtual network you want the network connection to use.|
    |**Subnet**|Select the subnet you want the network connection to use.|
 
-   :::image type="content" source="./media/how-to-manage-network-connection/create-native-network-connection-full-blank.png" alt-text="Screenshot showing the create network connection basics tab with Azure Active Directory join highlighted.":::
+:::image type="content" source="./media/how-to-manage-network-connection/create-native-network-connection-full-blank.png" alt-text="Screenshot showing the create network connection basics tab with Azure Active Directory join highlighted.":::
+
+1. Select **Review + Create**.
+
+1. On the **Review** tab, select **Create**.
+
+1. When the deployment is complete, select **Go to resource**. You'll see the Network Connection overview page.
 
-   #### [**Hybrid Azure AD join**](#tab/HybridAzureADJoin/)
+#### [**Hybrid Azure AD join**](#tab/HybridAzureADJoin/)
 
-   On the **Create a network connection** page, on the **Basics** tab, enter the following values:
+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**.
+
+1. On the **Network Connections** page, select **+Create**.
+     :::image type="content" source="./media/how-to-manage-network-connection/network-connections-empty.png" alt-text="Screenshot showing the Network Connections page with Create highlighted.":::
+
+1. On the **Create a network connection** page, on the **Basics** tab, enter the following values:
 
    |Name|Value|
    |----|----|
@@ -121,27 +145,28 @@ You can learn more about each type of join and how to plan for them here:
 
    :::image type="content" source="./media/how-to-manage-network-connection/create-hybrid-network-connection-full-blank.png" alt-text="Screenshot showing the create network connection basics tab with Hybrid Azure Active Directory join highlighted.":::
 
- ---
+1. Select **Review + Create**.
 
-Use the following steps to finish creating your network connection, for both Azure AD join and Hybrid Azure AD join:
-   1. Select **Review + Create**.
+1. On the **Review** tab, select **Create**.
 
-   1. On the **Review** tab, select **Create**.
+1. When the deployment is complete, select **Go to resource**. You'll see the Network Connection overview page.
 
-   1. When the deployment is complete, select **Go to resource**. You'll see the Network Connection overview page.
- 
+---
 
 ## Attach network connection to dev center
+
 You need to attach a network connection to a dev center before it can be used in projects to create dev box pools.
 
-1. In the [Azure portal](https://portal.azure.com), in the search box, type *Dev centers* and then select **Dev centers** from the list.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
+
+1. Select the dev center you created and select **Networking**.
 
-1. Select the dev center you created and select **Networking**. 
- 
 1. Select  **+ Add**.
- 
+
 1. In the **Add network connection** pane, select the network connection you created earlier, and then select **Add**. 
- 
+
    :::image type="content" source="./media/how-to-manage-network-connection/add-network-connection.png" alt-text="Screenshot showing the Add network connection pane.":::   
 
 After creation, several health checks are run on the network. You can view the status of the checks on the resource overview page. Network connections that pass all the health checks can be added to a dev center and used in the creation of dev box pools. The dev boxes within the dev box pools will be created and domain joined in the location of the VNet assigned to the network connection.
@@ -150,23 +175,24 @@ After creation, several health checks are run on the network. You can view the s
 
 To resolve any errors, refer to the [Troubleshoot Azure network connections](/windows-365/enterprise/troubleshoot-azure-network-connection).
 
-
 ## Remove a network connection from a dev center
+
 You can remove a network connection from a dev center if you no longer want it to be used to connect to network resources. Network connections can't be removed if they are in use by one or more dev box pools. 
 
-1. In the [Azure portal](https://portal.azure.com), in the search box, type *Dev centers* and then select **Dev centers** from the list.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+
+1. In the search box, enter **dev centers**. In the list of results, select **Dev centers**.
+
+1. Select the dev center you created and select **Networking**.
 
-1. Select the dev center you created and select **Networking**. 
- 
 1. Select  the network connection you want to remove and then select **Remove**.
 
-   :::image type="content" source="./media/how-to-manage-network-connection/remove-network-connection.png" alt-text="Screenshot showing the network connection page with Remove highlighted.":::   
+   :::image type="content" source="./media/how-to-manage-network-connection/remove-network-connection.png" alt-text="Screenshot showing the network connection page with Remove highlighted.":::
 
 1. Read the warning message, and then select **Ok**.
 
 The network connection will no longer be available for use in the dev center.
 
 ## Next steps
 
-<!-- [Manage a dev center](./how-to-manage-dev-center.md) -->
-- [Quickstart: Configure a Microsoft Dev Box Preview Project](./quickstart-configure-dev-box-project.md)
+- [Quickstart: Configure a Microsoft Dev Box Preview Project](./quickstart-configure-dev-box-project.md)
