Merge pull request #229582 from ShawnJackson/microsoft-dev-box-docset

[AQ] edit pass: Microsoft Dev Box docset (conceptual and quickstart articles)

Author: ktoliver

articles/dev-box/concept-dev-box-concepts.md

@@ -8,35 +8,50 @@ author: RoseHJM
 ms.author: rosemalcolm
 ms.topic: conceptual
 ms.date: 10/12/2022
-ms.custom: template-concept 
+ms.custom: template-concept
+#Customer intent: As a developer, I want to understand Dev Box concepts and terminology so that I can set up a Dev Box environment.
 ---
 
-<!-- 
-  Customer intent:
-	As a developer I want to understand Dev Box concepts and terminology so that I can set up Dev Box environment.
- -->
 # Microsoft Dev Box Preview key concepts
 
-This article describes the key concepts and components of Microsoft Dev Box. 
+This article describes the key concepts and components of Microsoft Dev Box Preview.
+
+## Dev box
+
+A dev box is a preconfigured, ready-to-code workstation that you create through the self-service developer portal. A new dev box has all the tools, binaries, and configuration required for a dev box user to be productive immediately. You can create and manage multiple dev boxes to work on multiple workstreams.
+
+As a dev box user, you have control over your own dev boxes. You can create more as you need them and delete them when you finish using them.
 
 ## Dev center
 
-A dev center is a collection of projects that require similar settings. Dev centers enable dev infrastructure managers to manage the images and SKUs available to the projects using [dev box definitions](concept-dev-box-concepts.md#dev-box-definition) and configure the networks the development teams consume using [network connections](./concept-dev-box-concepts.md#network-connection).  
-## Projects
+A dev center is a collection of projects that require similar settings. Dev centers enable dev infrastructure managers to:
+
+- Manage the images and SKUs available to the projects by using dev box definitions.
+- Configure the networks that the development teams consume by using network connections.  
+
+## Project
+
+A project is the point of access for development team members. When you associate a project with a dev center, all the settings at the dev center level are applied to the project automatically.
+
+Each project can be associated with only one dev center. Dev managers can configure the dev boxes available for a project by specifying the dev box definitions that are appropriate for their workloads.
 
-A project is the point of access for the development team members. When you associate a project with a dev center, all the settings at the dev center level will be applied to the project automatically. Each project can be associated with only one dev center. Dev managers can configure the dev boxes available for the project by specifying the [dev box definitions](./concept-dev-box-concepts.md#dev-box-definition) appropriate for their workloads.
 ## Dev box definition
 
-A dev box definition specifies a source image and size, including compute size and storage size. You can use a source image from the marketplace, or a custom image from your own [Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md). You can use dev box definitions across multiple projects in a dev center. 
+A dev box definition specifies a source image and size, including compute size and storage size. You can use a source image from Azure Marketplace or a custom image from your own [Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md) instance. You can use dev box definitions across multiple projects in a dev center.
+
+## Network connection
+
+IT administrators and dev infrastructure managers configure the network that's used for dev box creation in accordance with their organizational policies. Network connections store configuration information, like Active Directory join type and virtual network, that dev boxes use to connect to network resources.
+
+When you're creating a network connection, you must choose the Active Directory join type:
+
+- If your dev boxes need to connect exclusively to cloud-based resources, use native Azure Active Directory (Azure AD).
+- If your dev boxes need to connect to on-premises resources and cloud-based resources, use hybrid Azure AD.
 
-## Network connection 
+To learn more about native Azure AD join and hybrid Azure AD join, see [Plan your Azure Active Directory device deployment](../active-directory/devices/plan-device-deployment.md).
 
-IT administrators and dev infrastructure managers configure the network used for dev box creation in accordance with their organizational policies. Network connections store configuration information like Active Directory join type and virtual network that dev boxes use to connect to network resources. 
+The virtual network specified in a network connection also determines the region for a dev box. You can create multiple network connections based on the regions where you support developers. You can then use those connections when you're creating dev box pools to ensure that dev box users create dev boxes in a region close to them. Using a region close to the dev box user provides the best experience.
 
-When creating a network connection, you must choose whether to use a native Azure Active Directory (Azure AD) join or a hybrid Azure AD join. If your dev boxes need to connect exclusively to cloud-based resources, use a native Azure AD join. Use a hybrid Azure AD join if your dev boxes need to connect to on-premises resources and cloud-based resources. To learn more about Azure AD and hybrid Azure AD joined devices, [Plan your Azure Active Directory device deployment](../active-directory/devices/plan-device-deployment.md).
-The virtual network specified in a network connection also determines the region for the dev box. You can create multiple network connections based on the regions where you support developers and use them when creating different dev box pools to ensure dev box users create a dev box in a region close to them. Using a region close to the dev box user provides the best experience. 
+## Dev box pool
 
-## Dev box pool 
-A dev box pool is a collection of dev boxes that you manage together and to which you apply similar settings. You can create multiple dev box pools to support the needs of hybrid teams working in different regions or on different workloads.
-## Dev box 
-A dev box is a preconfigured ready-to-code workstation that you create through the self-service developer portal. The new dev box has all the tools, binaries, and configuration required for a dev box user to be productive immediately. You can create and manage multiple dev boxes to work on multiple work streams. As a dev box user, you have control over your own dev boxes - you can create more as you need them and delete them when you have finished using them.
+A dev box pool is a collection of dev boxes that you manage together and to which you apply similar settings. You can create multiple dev box pools to support the needs of hybrid teams that work in different regions or on different workloads.

articles/dev-box/includes/note-dev-box-runs-on-creation.md

@@ -7,4 +7,4 @@ ms.service: dev-box
 ---
 
 > [!IMPORTANT]
-> A dev box is automatically started and running when the creation process completes. Dev boxes incur costs whenever they are running.
+> A dev box is automatically started and running when the creation process finishes. Dev boxes incur costs whenever they're running.

articles/dev-box/includes/note-permission-to-create-dev-box.md

@@ -7,4 +7,4 @@ ms.service: dev-box
 ---
 
 > [!IMPORTANT]
-> A user that's assigned the Dev Box User role or the Project Admin role can create a dev box.
+> A user who is assigned the Dev Box User role or the Project Admin role can create a dev box.

articles/dev-box/index.yml

@@ -32,14 +32,14 @@ landingContent:
     linkLists:
       - linkListType: quickstart
         links:
-          - text: Configure the Microsoft Dev Box service
+          - text: Configure Microsoft Dev Box
             url: quickstart-configure-dev-box-service.md
-          - text: Create a Dev Box
+          - text: Create a dev box
             url: quickstart-create-dev-box.md  
           - text: Use the Remote Desktop client to connect to a dev box
             url: quickstart-connect-to-dev-box-with-remote-desktop-app.md
   # Card
-  - title: Provide access to dev box
+  - title: Provide access to Microsoft Dev Box
     linkLists:
       - linkListType: how-to-guide
         links:
@@ -53,17 +53,17 @@ landingContent:
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Configure an Azure Compute Gallery
+          - text: Configure Azure Compute Gallery
             url: how-to-configure-azure-compute-gallery.md
-          - text: Provision a custom image with Azure Image Builder
+          - text: Provision a custom image by using Azure VM Image Builder
             url: how-to-customize-devbox-azure-image-builder.md
 
    # Card
-  - title: Reference docs
+  - title: References
     linkLists:
       - linkListType: reference
         links:
-          - text: CLI
+          - text: Azure CLI
             url: https://learn.microsoft.com/en-us/azure/dev-box/cli-reference-subset
           - text: REST API
             url: https://aka.ms/dev-box/restapidocs