Merge pull request #215351 from ShawnJackson/provide-access-to-create-and-manage-environments

edit pass: "Provide access to create and manage environments" articles

Author: itechedit

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

@@ -1,7 +1,7 @@
 ---
-title: Configure deployment environments user access
+title: Provide access to developers
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure access for developers by using the Deployment Environments Users built-in role.
+description: Learn how to configure access for developers by using the Deployment Environments User built-in role.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
@@ -13,61 +13,61 @@ ms.topic: how-to
 
 # Provide access to developers
 
-Development team members must have access to a specific project before they can create deployment environments. By using the built-in Deployment Environments User role, you can assign permissions to Active Directory Users or Groups at either the project level or the specific project environment type level. 
+In Azure Deployment Environments, development team members must get access to a specific project before they can create deployment environments. By using the built-in Deployment Environments User role, you can assign permissions to Active Directory users or groups at either the project level or the environment type level. 
 
-Based on the scope that users are granted access to, a Deployment Environments User can:
+Based on the scope of access that you allow, a developer who has the Deployment Environments User role can:
 
-* View the project environment types 
-* Create an environment
-* Read, write, delete, or perform actions (deploy, reset, etc.) on their own environment
-* Read or perform actions (deploy, reset, etc.) on environments created by other users
+* View the project environment types. 
+* Create an environment.
+* Read, write, delete, or perform actions (like deploy or reset) on their own environment.
+* Read or perform actions (like deploy or reset) on environments that other users created.
 
-When the role is assigned at the project level, the Deployment Environments User will be able to perform the actions listed above on all environment types enabled at the Project level. When the role is assigned to specific environment type(s), the user will be able to perform the actions only on the respective environment type(s).
+When you assign the role at the project level, the user can perform the preceding actions on all environment types enabled at the project level. When you assign the role to specific environment types, the user can perform the actions only on the respective environment types.
 
-## Assign permissions to developers to a project
+## Assign permissions to developers for a project
 
-1. Select the project you want to provide your development team members access to.
-2. Select **Access Control(IAM)** from the left menu.
+1. Select the project that you want your development team members to be able to access.
+2. Select **Access control (IAM)** from the left menu.
 
-   :::image type="content" source=".\media\configure-deployment-environments-user\access-control-page.png" alt-text="Screenshot showing link to access control page.":::
+   :::image type="content" source=".\media\configure-deployment-environments-user\access-control-page.png" alt-text="Screenshot that shows the link to the access control page.":::
 
 3. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source=".\media\configure-deployment-environments-user\add-role-assignment.png" alt-text="Screenshot showing Add role assignment menu option.":::
+   :::image type="content" source=".\media\configure-deployment-environments-user\add-role-assignment.png" alt-text="Screenshot that shows the menu option for adding a role assignment.":::
 
-4. On the Add role assignment page, on the Role tab, search for *deployment environments user*, select the **Deployment Environments User** built-in role, and then select **Next**.
-5. On the Members tab, select **+ Select Members**.
-6. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
-7. On the Members tab, select **Review + assign**.
+4. On the **Add role assignment** page, on the **Role** tab, search for **deployment environments user**, select the **Deployment Environments User** built-in role, and then select **Next**.
+5. On the **Members** tab, select **+ Select members**.
+6. In **Select members**, select the Active Directory users or groups that you want to add, and then choose **Select**.
+7. On the **Members** tab, select **Review + assign**.
 
-The user can now view the project and all the Environment Types enabled within it. Deployment Environments users can [create environments from the CLI](./quickstart-create-access-environments.md).
+The users can now view the project and all the environment types that you've enabled within it. Users who have the Deployment Environments User role can also [create environments from the Azure CLI](./quickstart-create-access-environments.md).
 
-## Assign permissions to developers to a specific environment type
+## Assign permissions to developers for an environment type
 
-1. Select the project you want to provide your development team members access to.
-2. Select **Environment Types** and select the **...** beside the specific environment type.
+1. Select the project that you want your development team members to be able to access.
+2. Select **Environment types**, and then select the ellipsis (**...**) beside the specific environment type.
 
-   :::image type="content" source=".\media\configure-deployment-environments-user\project-environment-types.png" alt-text="Screenshot showing the environment types associated with a project.":::
+   :::image type="content" source=".\media\configure-deployment-environments-user\project-environment-types.png" alt-text="Screenshot that shows the environment types associated with a project.":::
 
-3. Select **Access Control**.
+3. Select **Access control (IAM)**.
 
-   :::image type="content" source=".\media\configure-deployment-environments-user\access-control-page.png" alt-text="Screenshot showing link to access control page.":::
+   :::image type="content" source=".\media\configure-deployment-environments-user\access-control-page.png" alt-text="Screenshot that shows the link to the access control page.":::
 
 4. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source=".\media\configure-deployment-environments-user\add-role-assignment.png" alt-text="Screenshot showing Add role assignment menu option.":::
+   :::image type="content" source=".\media\configure-deployment-environments-user\add-role-assignment.png" alt-text="Screenshot that shows the menu option for adding a role assignment.":::
 
-5. On the Add role assignment page, on the Role tab, search for *deployment environments user*, select the **Deployment Environments User** built-in role, and then select **Next**.
-6. On the Members tab, select **+ Select Members**.
-7. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
-8. On the Members tab, select **Review + assign**.
+5. On the **Add role assignment** page, on the **Role** tab, search for **deployment environments user**, select the **Deployment Environments User** built-in role, and then select **Next**.
+6. On the **Members** tab, select **+ Select members**.
+7. In **Select members**, select the Active Directory users or groups that you want to add, and then choose **Select**.
+8. On the **Members** tab, select **Review + assign**.
 
-The user can now view the project and the specific environment type that they have been granted access to. Deployment Environments users can [create environments using the CLI](./quickstart-create-access-environments.md).
+The users can now view the project and the specific environment type that you've granted them access to. Users who have the Deployment Environments User role can also [create environments by using the Azure CLI](./quickstart-create-access-environments.md).
 
 > [!NOTE]
-> Only users assigned the Deployment Environments User role, the DevCenter Project Admin role, or a built-in role with appropriate permissions will be able to create environments.
+> Only users who have the Deployment Environments User role, the DevCenter Project Admin role, or a built-in role with appropriate permissions can create environments.
 
 ## Next steps
 
-* [Create and Configure Projects](./quickstart-create-and-configure-projects.md)
-* [Provide access to Dev Managers](./how-to-configure-project-admin.md)
+* [Create and configure projects](./quickstart-create-and-configure-projects.md)
+* [Provide access to dev managers](./how-to-configure-project-admin.md)

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

@@ -1,5 +1,5 @@
 ---
-title: Configure deployment environments project admin access
+title: Provide access to dev managers
 titleSuffix: Azure Deployment Environments
 description: Learn how to configure access for dev managers by using the DevCenter Project Admin built-in role.
 ms.service: deployment-environments
@@ -10,75 +10,75 @@ ms.date: 10/12/2022
 ms.topic: how-to
 ---
 
-# Provide access to Dev Managers 
+# Provide access to dev managers 
 
-You can create multiple projects associated with the dev center to align with each team's specific requirements. By using the built-in DevCenter Project Admin role, you can delegate project administration to a member of a team. Project Admins can configure [project environment types](concept-environments-key-concepts.md#project-environment-types) to enable developers to create different types of [environments](concept-environments-key-concepts.md#environments) and apply different settings to each environment type. 
+In Azure Deployment Environments, you can create multiple projects associated with the dev center to align with each team's requirements. By using the built-in DevCenter Project Admin role, you can delegate project administration to a member of a team. DevCenter Project Admin users can configure [project environment types](concept-environments-key-concepts.md#project-environment-types) to enable developers to create various types of [environments](concept-environments-key-concepts.md#environments) and apply settings to each environment type. 
 
-The DevCenter Project Admin role can be assigned at either the project level or the specific project environment type level.
+You can assign the DevCenter Project Admin role to a dev manager at either the project level or the environment type level.
 
-Based on the scope that users are granted access to, a DevCenter Project Admin can:
+Based on the scope of access that you allow, a DevCenter Project Admin user can:
 
-* View, add, update, disable or delete the project environment types
-* Create an environment
-* Read, write, delete, or perform actions (deploy, reset, etc.) on their own environment
-* Read, delete, or perform actions (deploy, reset, etc.) on environments created by other users
+* View, add, update, disable, or delete the project environment types.
+* Create an environment.
+* Read, write, delete, or perform actions (like deploy or reset) on their own environment.
+* Read, delete, or perform actions (like deploy or reset) on environments that other users created.
 
-When the role is assigned at the project level, the DevCenter Project Admin can perform the actions listed above on all environment types at the Project level. When the role is assigned to specific environment type(s), the DevCenter Project Admin can perform the actions only on the respective environment type(s).
+When you assign the role at the project level, the user can perform the preceding actions on all environment types at the project level. When you assign the role to specific environment types, the user can perform the actions only on the respective environment types.
 
-## Assign permissions to dev managers to a project
+## Assign permissions to dev managers for a project
 
-1. Select the project you want to provide your development team members access to.
-2. Select **Access Control(IAM)** from the left menu.
+1. Select the project that you want your development team members to be able to access.
+2. Select **Access control (IAM)** from the left menu.
 
-   :::image type="content" source=".\media\configure-project-admin\access-control-page.png" alt-text="Screenshot showing link to access control page.":::
+   :::image type="content" source=".\media\configure-project-admin\access-control-page.png" alt-text="Screenshot that shows the link to the access control page.":::
 
 3. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source=".\media\configure-project-admin\add-role-assignment.png" alt-text="Screenshot showing Add role assignment menu option.":::
+   :::image type="content" source=".\media\configure-project-admin\add-role-assignment.png" alt-text="Screenshot that shows the menu option for adding a role assignment.":::
 
-4. 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**.
+4. 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\configure-project-admin\built-in-role.png" alt-text="Screenshot showing built-in DevCenter project admin role.":::
+   :::image type="content" source=".\media\configure-project-admin\built-in-role.png" alt-text="Screenshot that shows selecting the built-in DevCenter Project Admin role.":::
 
-5. On the Members tab, select **+ Select Members**.
+5. On the **Members** tab, select **+ Select members**.
 
-    :::image type="content" source=".\media\configure-project-admin\select-role-members.png" alt-text="Screenshot showing link to select role members pane.":::
+    :::image type="content" source=".\media\configure-project-admin\select-role-members.png" alt-text="Screenshot that shows the link for selecting role members.":::
 
-1. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
+1. In **Select members**, select the Active Directory users or groups that you want to add, and then choose **Select**.
 
-7. On the Members tab, select **Review + assign**.
+7. On the **Members** tab, select **Review + assign**.
 
-The user will now be able to view the project and manage all the Environment Types that have been enabled within it. DevCenter Project Admin can also [create environments from the CLI](./quickstart-create-access-environments.md).
+The users can now view the project and manage all the environment types that you've enabled within it. DevCenter Project Admin users can also [create environments from the Azure CLI](./quickstart-create-access-environments.md).
 
-## Assign permissions to dev managers to a specific environment type
+## Assign permissions to dev managers for an environment type
 
-1. Select the project you want to provide your development team members access to.
-2. Select **Environment Types** and select the **...** beside the specific environment type.
+1. Select the project that you want your development team members to be able to access.
+2. Select **Environment types**, and then select the ellipsis (**...**) beside the specific environment type.
 
-   :::image type="content" source=".\media\configure-project-admin\project-environment-types.png" alt-text="Screenshot showing the environment types associated with a project.":::
+   :::image type="content" source=".\media\configure-project-admin\project-environment-types.png" alt-text="Screenshot that shows the environment types associated with a project.":::
 
-3. Select **Access Control**.
+3. Select **Access control (IAM)**.
 
-   :::image type="content" source=".\media\configure-project-admin\access-control-page.png" alt-text="Screenshot showing link to access control page.":::
+   :::image type="content" source=".\media\configure-project-admin\access-control-page.png" alt-text="Screenshot that shows the link to the access control page.":::
 
 4. Select **Add** > **Add role assignment**.
 
-   :::image type="content" source=".\media\configure-project-admin\add-role-assignment.png" alt-text="Screenshot showing Add role assignment menu option.":::
+   :::image type="content" source=".\media\configure-project-admin\add-role-assignment.png" alt-text="Screenshot that shows the menu option for adding a role assignment.":::
 
-5. 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**.
+5. 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\configure-project-admin\built-in-role.png" alt-text="Screenshot showing built-in DevCenter project admin role.":::
+   :::image type="content" source=".\media\configure-project-admin\built-in-role.png" alt-text="Screenshot that shows selecting the built-in DevCenter Project Admin role.":::
 
-6. On the Members tab, select **+ Select Members**.
-7. In **Select members**, select the Active Directory Users or Groups you want to add, and then select **Select**.
-8. On the Members tab, select **Review + assign**.
+6. On the **Members** tab, select **+ Select members**.
+7. In **Select members**, select the Active Directory users or groups that you want to add, and then choose **Select**.
+8. On the **Members** tab, select **Review + assign**.
 
-The user will now be able to view the project and manage only the specific environment type that they have been granted access to. DevCenter Project Admin can also [create environments using the CLI](./quickstart-create-access-environments.md).
+The users can now view the project and manage only the specific environment type that you've granted them access to. DevCenter Project Admin users can also [create environments by using the Azure CLI](./quickstart-create-access-environments.md).
 
 > [!NOTE]
-> Only users assigned the Deployment Environments User role, the DevCenter Project Admin role, or a built-in role with appropriate permissions will be able to create environments.
+> Only users who have the Deployment Environments User role, the DevCenter Project Admin role, or a built-in role with appropriate permissions can create environments.
 
 ## Next steps
 
-* [Create and Configure Projects](./quickstart-create-and-configure-projects.md)
+* [Create and configure projects](./quickstart-create-and-configure-projects.md)
 * [Provide access to developers](./how-to-configure-deployment-environments-user.md)