Updates to MDB files.

Author: RoseHJM

articles/deployment-environments/how-to-configure-deployment-environments-user.md

@@ -37,7 +37,7 @@ When you assign the role at the project level, the user can perform the precedin
     | Setting | Value |
     | --- | --- |
     | **Role** | Select **[Deployment Environments user](how-to-configure-deployment-environments-user.md)**. |
-    | **Assign access to** | Select a **User, group, or service principal**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups you want to have access to the project. |
 
     :::image type="content" source="media/quickstart-create-configure-projects/add-role-assignment.png" alt-text="Screenshot that shows the Add role assignment pane.":::
@@ -60,7 +60,7 @@ The users can now view the project and all the environment types that you've ena
     | Setting | Value |
     | --- | --- |
     | **Role** | Select [Deployment Environments user](how-to-configure-deployment-environments-user.md). |
-    | **Assign access to** | Select a **User, group, or service principal**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups you want to have access to the project. |
 
     :::image type="content" source="media/quickstart-create-configure-projects/add-role-assignment.png" alt-text="Screenshot that shows the Add role assignment pane.":::

articles/deployment-environments/how-to-configure-project-admin.md

@@ -36,7 +36,7 @@ When you assign the role at the project level, the user can perform the precedin
     | Setting | Value |
     | --- | --- |
     | **Role** | Select **DevCenter Project Admin**. |
-    | **Assign access to** | Select a **User, group, or service principal**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups you want to have administrative access to the project. |
 
     :::image type="content" source="media/configure-project-admin/add-role-assignment-admin.png" alt-text="Screenshot that shows the Add role assignment pane.":::
@@ -59,7 +59,7 @@ The users can now view the project and manage all the environment types that you
     | Setting | Value |
     | --- | --- |
     | **Role** | Select **DevCenter Project Admin**. |
-    | **Assign access to** | Select a **User, group, or service principal**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups you want to have administrative access to the project. |
 
     :::image type="content" source="media/configure-project-admin/add-role-assignment-admin.png" alt-text="Screenshot that shows the Add role assignment pane.":::

articles/deployment-environments/quickstart-create-and-configure-projects.md

@@ -112,7 +112,7 @@ To configure a project, add a [project environment type](how-to-configure-projec
     | Setting | Value |
     | --- | --- |
     | **Role** | Select **[Deployment Environments user](how-to-configure-deployment-environments-user.md)**. |
-    | **Assign access to** | Select a **User, group, or service principal**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
     | **Members** | Select the users or groups you want to have access to the project. |
 
     :::image type="content" source="media/quickstart-create-configure-projects/add-role-assignment.png" alt-text="Screenshot that shows the Add role assignment pane.":::

articles/dev-box/how-to-configure-azure-compute-gallery.md

@@ -74,35 +74,30 @@ Follow these steps to manually assign each role:
 
 1. Select the **Access Control (IAM)** menu item.
 
-1. Select **+ Add** > **Add role assignment**.
+1. Select **Add** > **Add role assignment**.
 
-1. On the Role tab, select **Reader**, and then select **Next**.
-
-1. On the Members tab, select **+ Select Members**.
-
-1. In Select members, search for *Windows 365*, select **Windows 365** from the list, and then select **Select**. 
-
-1. On the Members tab, select **Next**.
-
-1. On the Review + assign tab, select **Review + assign**.
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **Role** | Select **Reader**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
+    | **Members** | Search for and select **Windows 365**. |
 
 #### Dev center Managed Identity
 1. Open the gallery you want to attach to the dev center from the [Azure portal](https://portal.azure.com/#blade/HubsExtension/BrowseResource/resourceType/Microsoft.Compute%2Fgalleries). You can also search for Azure Compute Galleries to find your gallery.
 
 1. Select **Access Control (IAM)** from the left menu.
 
-1. Select **+ Add** > **Add role assignment**.
-
-1. On the Role tab, select the **Contributor** role, and then select **Next**.
-
-1. On the Members tab, under **Assign access to**, select **Managed Identity**, and then select **+ Select Members**.
-
-1. In Select managed identities, search for and select the user assigned managed identity you created in "Create a Dev center Managed Identity" and then select 
-**Select**.
-
-1. On the Members tab, select **Next**.
+1. Select **Add** > **Add role assignment**.
 
-1. On the Review + assign tab, select **Review + assign**.
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **Role** | Select **Contributor**. |
+    | **Assign access to** | Select **Managed Identity**. |
+    | **Members** | Search for and select the user assigned managed identity you created in [Add a user assigned identity to dev center](#add-a-user-assigned-identity-to-dev-center). |
 
 You can use the same managed identity in multiple DevCenters and Azure Compute Galleries. Any DevCenter with the managed identity added will have the necessary permissions to the images in the Azure Compute Gallery you've added the owner role assignment to.
 

articles/dev-box/how-to-dev-box-user.md

@@ -36,25 +36,17 @@ A DevCenter Dev Box User can:
 
 1. Select **Access Control (IAM)** from the left menu.
 
-   :::image type="content" source="./media/how-to-dev-box-user/access-control-tab.png " alt-text="Screenshot showing the Project Access control page with the Access Control link highlighted.":::
-
 1. Select **Add** > **Add role assignment**.
- 
-   :::image type="content" source="./media/how-to-dev-box-user/add-role-assignment.png" alt-text="Screenshot showing the Add menu with Add role assignment highlighted.":::
-
-1. On the Add role assignment page, on the Role tab, search for *devcenter dev box user*, select the **DevCenter Dev Box User** built-in role, and then select **Next**.
- 
-   :::image type="content" source="./media/how-to-dev-box-user/dev-box-user-role.png" alt-text="Screenshot showing the search box.":::
 
-1. On the Members tab, select **+ Select Members**.
- 
-   :::image type="content" source="./media/how-to-dev-box-user/dev-box-user-select-members.png" alt-text="Screenshot showing the Members tab with Select members highlighted.":::
-
-1. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
- 
-   :::image type="content" source="./media/how-to-dev-box-user/select-members-search.png" alt-text="Screenshot showing the Select members pane with a user account highlighted.":::
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **Role** | Select **DevCenter Dev Box User**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
+    | **Members** | Select the users or groups you want to have access to the project. |
 
-1. On the Members tab, select **Review + assign**.
+    :::image type="content" source="media/how-to-dev-box-user/add-role-assignment-user.png" alt-text="Screenshot that shows the Add role assignment pane.":::
 
 The user will now be able to view the project and all the pools within it. Dev box users can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
 

articles/dev-box/how-to-manage-dev-box-projects.md

@@ -96,25 +96,17 @@ Before users can create dev boxes based on the dev box pools in a project, you m
 
 1. Select **Access Control (IAM)** from the left menu.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/access-control-tab.png" alt-text="Screenshot showing the Project Access control page with the Access Control link highlighted.":::
-
 1. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/add-role-assignment.png" alt-text="Screenshot showing the Add menu with Add role assignment highlighted.":::
-
-1. On the Add role assignment page, search for *devcenter dev box user*, select the **DevCenter Dev Box User** built-in role, and then select **Next**.
-
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/dev-box-user-role.png" alt-text="Screenshot showing the Add role assignment search box highlighted.":::
-
-1. On the Members page, select **+ Select Members**.
-
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/dev-box-user-select-members.png" alt-text="Screenshot showing the Members tab with Select members highlighted.":::
-
-1. On the **Select members** pane, select the Active Directory Users or Groups you want to add, and then select **Select**.
-
-   :::image type="content" source="./media/how-to-manage-dev-box-projects/select-members-search.png" alt-text="Screenshot showing the Select members pane with a user account highlighted.":::
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **Role** | Select **DevCenter Dev Box User**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
+    | **Members** | Select the users or groups you want to have access to the project. |
 
-1. On the Add role assignment page, select **Review + assign**.
+    :::image type="content" source="media/how-to-manage-dev-box-projects/add-role-assignment-user.png" alt-text="Screenshot that shows the Add role assignment pane.":::
 
 The user will now be able to view the project and all the pools within it. They can create dev boxes from any of the pools and manage those dev boxes from the [developer portal](https://aka.ms/devbox-portal).
 

articles/dev-box/how-to-manage-dev-center.md

@@ -118,25 +118,16 @@ To make role assignments, use the following steps:
 
 1. Select **Access Control (IAM)** from the left menu.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/dev-center-access-control.png" alt-text="Screenshot showing the dev center page with the Access Control link highlighted.":::
-
 1. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source="./media/how-to-manage-dev-center/add-role-assignment.png" alt-text="Screenshot showing the Add menu with Add role assignment highlighted.":::
-
-1. On the Add role assignment page, choose the built-in role you want to assign, and then select **Next**.
-
-   :::image type="content" source="./media/how-to-manage-dev-center/dev-center-built-in-roles.png" alt-text="Screenshot showing the Add role assignment search box highlighted.":::
-
-1. On the Members page, select **+ Select Members**.
-
-   :::image type="content" source="./media/how-to-manage-dev-center/dev-center-owner-select-members.png" alt-text="Screenshot showing the Members tab with Select members highlighted.":::
-
-1. On the **Select members** pane, select the Active Directory Users or Groups you want to add, and then select **Select**.
-
-   :::image type="content" source="./media/how-to-manage-dev-center/select-members-search.png" alt-text="Screenshot showing the Select members pane with a user account highlighted.":::
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **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. |
 
-1. On the Add role assignment page, select **Review + assign**.
 ## Next steps
 
 - [Provide access to projects for project admins](./how-to-project-admin.md)

articles/dev-box/how-to-project-admin.md

@@ -37,22 +37,16 @@ Follow the instructions below to add role assignments for this role.
    :::image type="content" source="./media/how-to-project-admin/access-control-tab.png" alt-text="Screenshot showing the Project Access control page with the Access Control link highlighted.":::
 
 1. Select **Add** > **Add role assignment**.
- 
-   :::image type="content" source="./media/how-to-project-admin/add-role-assignment.png" alt-text="Screenshot showing the Add menu with Add role assignment highlighted.":::
-
-1. On the Add role assignment page, on the Role tab, search for *devcenter project admin*, select the **DevCenter Project Admin** built-in role, and then select **Next**.
- 
-   :::image type="content" source="./media/how-to-project-admin/project-admin-role.png" alt-text="Screenshot showing the search box highlighted.":::
 
-1. On the Members tab, select **+ Select Members**.
- 
-   :::image type="content" source="./media/how-to-project-admin/project-admin-select-members.png" alt-text="Screenshot showing the Members tab with Select members highlighted.":::
-
-1. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
- 
-   :::image type="content" source="./media/how-to-project-admin/select-members-search.png" alt-text="Screenshot showing the Select members pane with a user account highlighted.":::
+1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
+    
+    | Setting | Value |
+    | --- | --- |
+    | **Role** | Select **DevCenter Dev Box Admin**. |
+    | **Assign access to** | Select **User, group, or service principal**. |
+    | **Members** | Select the users or groups you want to have administrative access to the project. |
 
-1. On the Members tab, select **Review + assign**.
+    :::image type="content" source="media/how-to-project-admin/add-role-assignment-admin.png" alt-text="Screenshot that shows the Add role assignment pane.":::
 
 The user will now be able to manage the project and create dev box pools within it.