Merge pull request #302994 from RoseHJM/mdb-add-video

MDB - Add video

Author: JillGrant615

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

@@ -16,10 +16,6 @@ ms.custom: template-concept
 
 In this article, you learn about the architecture and key concepts for Microsoft Dev Box. Microsoft Dev Box gives developers self-service access to preconfigured, and ready-to-code cloud-based workstations. You can configure the service to meet your development team and project structure, and manage security and network settings to access resources securely.
 
-Microsoft Dev Box builds on the same foundations as [Azure Deployment Environments](/azure/deployment-environments/overview-what-is-azure-deployment-environments). Deployment Environments provides developers with preconfigured cloud-based environments for developing applications. Both services are complementary and share certain architectural components, such as a dev center or project.
-
-For an overview of Microsoft Dev Box, see [Beyond VDI: Get secure cloud dev environments with Microsoft Dev Box](https://devblogs.microsoft.com/develop-from-the-cloud/devboxignite2024/).
-
 ## How does Microsoft Dev Box work?
 
 Before developers can create dev boxes in the developer portal, you set up a dev center and project in Microsoft Dev Box. The following diagram gives an overview of the relationship between the different components in Microsoft Dev Box.
@@ -30,7 +26,7 @@ A dev center is the top-level resource for Microsoft Dev Box. A dev center conta
 
 A dev box project is the point of access for development teams. You assign a developer the Dev Box User role to a project to grant the developer permissions to create dev boxes. You can create one or more projects in a dev center.
 
-A dev box definition specifies the configuration of the dev boxes, such as the virtual machine image and compute resources for the dev box. You can either choose a VM image from the Azure Marketplace, or use an Azure compute gallery to use custom VM images.
+A dev box definition specifies the configuration of the dev boxes, such as the virtual machine image and compute resources for the dev box. You can either choose a VM image from Azure Marketplace, or use an Azure compute gallery to use custom VM images.
 
 A project contains the collection of dev box pools. A dev box pool specifies the configuration for dev boxes, such as the dev box definition, the network connection, and other settings. All dev boxes that are created from a dev box pool share the same configuration.
 
@@ -50,7 +46,7 @@ Microsoft Dev Box manages the capacity and in-region availability in the Microso
 
 To protect your data, Microsoft Dev Box encrypts the disk by default using a platform-managed key. You don't need to enable BitLocker and doing so can prevent you from accessing your dev box.
 
-For more information about data storage and protection in Azure services see: [Azure customer data protection](/azure/security/fundamentals/protection-customer-data). 
+For more information about data storage and protection in Azure services, see: [Azure customer data protection](/azure/security/fundamentals/protection-customer-data). 
 
 For the network connection, you can also choose between a Microsoft-hosted network connection, and an Azure network connection that you create in your own subscription.
 

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

@@ -17,7 +17,8 @@ This article describes the key concepts and components of Microsoft Dev Box to h
 
 Microsoft Dev Box gives developers self-service access to preconfigured and ready-to-code cloud-based workstations. You can configure the service to meet your development team and project structure, manage security, and network settings to access resources securely. Different components play a part in the configuration of Microsoft Dev Box.
 
-Microsoft Dev Box builds on the same foundations as [Azure Deployment Environments](/azure/deployment-environments/overview-what-is-azure-deployment-environments). Deployment Environments provides developers with preconfigured cloud-based environments for developing applications. The services are complementary and share certain architectural components, such as a [dev center](#dev-center) or [project](#project).
+Watch this video to learn more about Microsoft Dev Box:
+>[!VIDEO https://learn-video.azurefd.net/vod/player?id=c0df17f8-bafe-494d-9a64-6743de3e5555]
 
 This diagram shows the key components of Dev Box and how they relate to each other. You can learn more about each component in the following sections.
 
@@ -50,6 +51,10 @@ To enable developers to create their own dev boxes, you must [provide access to
 
 You can configure projects for [Deployment Environments](../deployment-environments/concept-environments-key-concepts.md#projects) and projects for Dev Box resources in the same dev center.
 
+## Project Policies
+
+A project policy in Microsoft Dev Box defines which resources—such as images, networks, and SKUs—are available to a project, enforcing governance and compliance. It ensures that development teams can only use approved resources, helping organizations control and streamline resource usage.
+
 ## Dev box definition
 
 A dev box definition specifies a source image and size, including compute size and storage size. Select a source image from Azure Marketplace or a custom image from your own [Azure Compute Gallery](./how-to-configure-azure-compute-gallery.md) instance. Dev Box supports client editions of Windows 10 and Windows 11. You can use dev box definitions across multiple projects in a dev center.

articles/dev-box/index.yml

@@ -25,10 +25,10 @@ landingContent:
         links:
           - text: What is Microsoft Dev Box?
             url: overview-what-is-microsoft-dev-box.md
-          - text: Architecture overview
-            url: concept-dev-box-architecture.md
           - text: Microsoft Dev Box concepts
             url: concept-dev-box-concepts.md
+          - text: Architecture overview
+            url: concept-dev-box-architecture.md
           - text: Microsoft Dev Box Roadmap
             url: dev-box-roadmap.md
       - linkListType: learn

articles/dev-box/toc.yml

@@ -25,14 +25,14 @@ items:
         href: quickstart-team-customizations.md
   - name: Concepts
     items:
+      - name: Key concepts
+        href: concept-dev-box-concepts.md
       - name: Architecture overview
         href: concept-dev-box-architecture.md
         displayName: Architecture,concepts,what is,overview,dev box,devbox,dev center,devcenter,project,networking,intune,azure
       - name: Network requirements
         href: concept-dev-box-network-requirements.md
         displayName: Network,firewall,endpoints,ports,connect,network connection,native,hybrid,hosted,tags
-      - name: Key concepts
-        href: concept-dev-box-concepts.md
       - name: Azure role-based access control
         href: concept-dev-box-role-based-access-control.md
         displayName: RBAC,role-based access control,permissions,access,role,role assignment,role definition