Merge pull request #250709 from RoseHJM/mdb-ade-common-components

Removed ADE common components article

Author: American-Dipper

articles/deployment-environments/.openpublishing.redirection.deployment-environments.json

@@ -24,6 +24,11 @@
       "source_path_from_root": "/articles/deployment-environments/configure-catalog-item.md",
       "redirect_url": "/azure/deployment-environments/configure-environment-definition",
       "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/deployment-environments/concept-common-components.md",
+      "redirect_url": "/azure/dev-box/concept-common-components",
+      "redirect_document_id": false
     }
   ]
 }

articles/deployment-environments/concept-common-components.md

@@ -73,6 +73,14 @@ An environment definition is a combination of an IaC template and a manifest fil
 
 To learn about the structure of an ARM template, the sections of a template, and the properties that are available in those sections, see [Understand the structure and syntax of Azure Resource Manager templates](../azure-resource-manager/templates/syntax.md).
 
-## Next steps
+## Resources shared with Microsoft Dev Box
 
-[Quickstart: Create and configure a dev center](./quickstart-create-and-configure-devcenter.md)
+Azure Deployment Environments and Microsoft Dev Box are complementary services that share certain architectural components. Dev centers and projects are common to both services, and they help organize resources in an enterprise. You can configure projects for Deployment Environments and projects for Dev Box resources in the same dev center. 
+
+To learn more about the components common to Deployment Environments and Dev Box, see [Components common to Microsoft Dev Box and Azure Deployment Environments](/azure/dev-box/concept-common-components).
+
+## Related content
+
+- [What is Azure Deployment Environments?](overview-what-is-azure-deployment-environments.md)
+- [Quickstart: Create and configure a dev center](./quickstart-create-and-configure-devcenter.md)
+- [What is Microsoft Dev Box?](../dev-box/overview-what-is-microsoft-dev-box.md)

articles/deployment-environments/concept-environments-key-concepts.md

@@ -24,8 +24,6 @@ items:
       href: concept-environments-key-concepts.md
     - name: Usage scenarios
       href: concept-environments-scenarios.md
-    - name: Deployment Environments and Dev Box components 
-      href: concept-common-components.md
     - name: Reliability in Azure Deployment Environments
       href: concept-environments-reliability-availability.md  
 - name: How-to guides

articles/deployment-environments/toc.yml

@@ -1,16 +1,81 @@
 ---
-title: Components common to Azure Deployment Environments and Microsoft Dev Box
+title: Components common to Microsoft Dev Box and Azure Deployment Environments
 description: Discover the components shared by Microsoft Dev Box and Azure Deployment Environments.
 ms.service: dev-box
 ms.custom: ignite-2022
 ms.topic: conceptual
 ms.author: rosemalcolm
 author: RoseHJM
-ms.date: 06/23/2023
+ms.date: 09/07/2023
 ---
 # Components common to Microsoft Dev Box and Azure Deployment Environments 
 
-> [!TIP]
-> Welcome to the **Microsoft Dev Box** documentation. If you're looking for information about **Azure Deployment Environments**, follow this link: [*Components common to Azure Deployment Environments and Microsoft Dev Box*](../deployment-environments/concept-common-components.md).
+Microsoft Dev Box and Azure Deployment Environments are complementary services that share certain architectural components. Dev centers and projects are common to both services, and they help organize resources in an enterprise. You can configure dev centers and projects in the Azure portal.
 
-[!INCLUDE [ade-mdb-common-components](../../includes/ade-mdb-common-components/ade-mdb-common-components.md)]
+## Common components
+
+The diagram shows the components of Dev Box and Deployment Environments. Dev centers and projects are common to both services. Both use managed identities to support authentication, and both services provide access for developers through the developer portal.
+
+:::image type="content" source="media/concept-common-components/common-elements.png" border="false" alt-text="Diagram showing components of Microsoft Dev Box and Azure Deployment Environments.":::
+
+The following table lists Dev Box and Deployment Environments components:
+
+|  Component             |   Dev Box    | Deployment Environments |
+|------------------------|--------------|-------------------------|
+|  Dev centers           |     Yes      |         Yes             |
+|  Projects              |     Yes      |         Yes             |
+|  Dev box pools         |     Yes      |         No              |
+|  Dev box definitions   |     Yes      |         No              |
+|  Dev boxes             |     Yes      |         No              |
+|  Compute galleries     |     Yes      |         No              |
+|  Managed identities    |     Yes      |         Yes             |
+|  Environment types     |     No       |         Yes             |
+|  Environments          |     No       |         Yes             |
+|  Catalogs              |     No       |         Yes             |
+|  Developer portal      |     Yes      |         Yes             |
+
+## How components appear in the Azure portal
+
+As you work with Dev Box or Deployment Environments in the Azure portal, you can access components from both services.
+
+In the dev center overview, you can access options to:
+
+(1) Configure your dev boxes.
+
+(2) Configure your environments.
+
+:::image type="content" source="media/concept-common-components/dev-center-overview.png" alt-text="Screenshot showing Dev Box and Deployment Environments components in a dev center.":::
+
+In the projects overview, you can access options to:
+
+(1) Configure environment types for a specific project.
+
+(2) Manage dev box pools and environments.
+
+:::image type="content" source="media/concept-common-components/project-overview.png" alt-text="Screenshot showing Dev Box and Deployment Environments components in a project.":::
+
+You might also see informational messages that refer to a service you aren't using, like this one from the projects overview:
+
+:::image type="content" source="media/concept-common-components/project-informational.png" alt-text="Screenshot showing an informational message.":::
+
+If you're not configuring for the service named in the informational message, you can safely ignore it.
+
+## Developer portal
+
+You can access your dev boxes and deployment environments through the [developer portal](https://devportal.microsoft.com/). You see existing dev boxes and environments displayed as shown in this screenshot:
+
+:::image type="content" source="media/concept-common-components/developer-portal.png" alt-text="Screenshot showing dev boxes and environments in the developer portal.":::
+
+You can create new dev boxes and environments through the developer portal menu at the top right.
+
+:::image type="content" source="media/concept-common-components/developer-portal-menu.png" alt-text="Screenshot that shows the developer portal menu.":::
+
+And you can manage your existing dev boxes and environments, too. Select the **more actions** menu on the relevant card. Here's an example of managing an environment:
+
+:::image type="content" source="media/concept-common-components/manage-environment.png" alt-text="Screenshot that shows options for managing an environment.":::
+
+## Next steps
+
+- To learn how to configure Microsoft Dev Box, see [Quickstart: Configure the Microsoft Dev Box service](../../articles/dev-box/quickstart-configure-dev-box-service.md).
+
+- To learn how to configure Azure Deployment Environments, see [Quickstart: Create and configure a dev center](../../articles/deployment-environments/quickstart-create-and-configure-devcenter.md).

articles/dev-box/concept-common-components.md

@@ -53,4 +53,16 @@ The virtual network specified in a network connection also determines the region
 
 ## 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 that work in different regions or on different workloads.
+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.
+
+## Resources shared with Azure Deployment Environments
+
+Microsoft Dev Box and Azure Deployment Environments are complementary services that share certain architectural components. Dev centers and projects are common to both services, and they help organize resources in an enterprise. You can configure projects for Deployment Environments and projects for Dev Box resources in the same dev center. 
+
+To learn more about the components common to Deployment Environments and Dev Box, see [Components common to Microsoft Dev Box and Azure Deployment Environments](concept-common-components.md).
+
+## Related content
+
+- [What is Microsoft Dev Box?](overview-what-is-microsoft-dev-box.md)
+- [Quickstart: Configure Microsoft Dev Box](quickstart-configure-dev-box-service.md)
+- [What is Azure Deployment Environments?](../deployment-environments/overview-what-is-azure-deployment-environments.md)