Merge pull request #215302 from ShawnJackson/configure-environment-types

edit pass: "Configure environment types" articles

Author: itechedit

articles/deployment-environments/how-to-configure-devcenter-environment-types.md

@@ -1,7 +1,7 @@
 ---
-title: Configure Dev center environment types
+title: Configure dev center environment types
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure dev center environment types to define the types of environments that your developers can deploy.
+description: Learn how to configure dev center environment types to define environments that your developers can deploy.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
@@ -10,56 +10,56 @@ ms.date: 10/12/2022
 ms.topic: how-to
 ---
 
-# Configure environment types for your Dev center
+# Configure environment types for your dev center
 
-In Azure Deployment Environments Preview, [environment types](./concept-environments-key-concepts.md#dev-center-environment-types) are used to define the types of environments available to development teams to deploy. You have the flexibility to name the environment types as per the nomenclature used in your enterprise, for example, sandbox, dev, test, or production. You can specify deployment settings and the permissions available to developers per environment type per project. 
+In Azure Deployment Environments Preview, you use [environment types](./concept-environments-key-concepts.md#dev-center-environment-types) to define the environments that development teams can deploy. You have the flexibility to name the environment types according to the nomenclature that your enterprise uses: for example, sandbox, dev, test, or production. You can specify deployment settings and the permissions that are available to developers per environment type and per project. 
 
 In this article, you'll learn how to:
 
-* Add a new environment type to your dev center
-* Delete an environment type from the dev center
+* Add a new environment type to a dev center.
+* Delete an environment type from a dev center.
 
-:::image type="content" source="./media/configure-dev-center-environment-types/azure-deployment-environments-environment-types.png" alt-text="Screenshot of example Environment types.":::
+:::image type="content" source="./media/configure-dev-center-environment-types/azure-deployment-environments-environment-types.png" alt-text="Screenshot of example environment types.":::
 
 > [!IMPORTANT]
 > Azure Deployment Environments is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
 ## Add a new dev center environment type
 
-Environment types allow your development teams to choose from different types of environments when creating self-service environments. 
-
 Add a new environment type to the dev center as follows:
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
-1. Access Azure Deployment Environments.
+1. Open Azure Deployment Environments.
 1. Select your dev center from the list.
 1. Select **Environment types** from the left pane.
-1. Select **+ Add**
+1. Select **+ Add**.
 1. On the **Add environment type** page, add the following details:
-  1. Add a **Name** for the environment type.
-  1. Add a **Description** (optional).
-  1. Add **Tags** by adding **Name/Value** (optional).
+   1. For **Name**, add a name for the environment type.
+   1. For **Description**, add a description (optional).
+   1. For **Tags**, add tags by adding **Name** and **Value** information (optional).
 1. Select **Add**.
 
-:::image type="content" source="./media/configure-dev-center-environment-types/add-new-dev-center-environment-type.png" alt-text="Screenshot showing the add environment type page.":::
+:::image type="content" source="./media/configure-dev-center-environment-types/add-new-dev-center-environment-type.png" alt-text="Screenshot that shows the page for adding an environment type.":::
 
 >[!NOTE]
-> A dev center environment type is available to a specific project only after an associated [project environment type](how-to-configure-project-environment-types.md) is added.
+> A dev center environment type is available to a specific project only after you add an associated [project environment type](how-to-configure-project-environment-types.md).
 
 ## Delete a dev center environment type
 
 > [!NOTE] 
-> Environment types can't be deleted if any existing project environment types or deployed environments reference the specific dev center environment type. Delete all the associated deployed environments and project environment types before attempting to delete an environment type.
+> You can't delete a dev center environment type if any existing project environment types or deployed environments reference it. Delete all the associated project environment types and deployed environments before you try to delete a dev center environment type.
  
-When you delete an environment type, it'll no longer be available when deploying environments or configuring new project environment types.
+When you delete an environment type, it will no longer be available when you're deploying environments or configuring new project environment types.
+
+To delete an environment type from a dev center:
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
-1. Access Azure Deployment Environments.
+1. Open Azure Deployment Environments.
 1. Select your dev center from the list.
 1. Select **Environment types** from the left pane.
-1. Select the environment type(s) you want to delete.
-1. Select **Delete** and confirm.
+1. Select the environment types that you want to delete.
+1. Select **Delete** and then confirm.
 
 ## Next steps
 
-* [Create and configure project environment type](how-to-configure-project-environment-types.md) to enable environment types for specific projects.
+* [Create and configure environment types for specific projects](how-to-configure-project-environment-types.md)

articles/deployment-environments/how-to-configure-project-environment-types.md

@@ -1,7 +1,7 @@
 ---
 title: Configure project environment types
 titleSuffix: Azure Deployment Environments
-description: Learn how to configure environment types to define deployment settings and permissions available to developers when deploying environments in a project.
+description: Learn how to configure environment types to define deployment settings and permissions available to developers when they're deploying environments in a project.
 ms.service: deployment-environments
 ms.custom: ignite-2022
 ms.author: rosemalcolm
@@ -12,92 +12,98 @@ ms.topic: how-to
 
 # Configure project environment types
 
-Project environment types are a subset of the [environment types configured per dev center](how-to-configure-devcenter-environment-types.md) and help pre-configure the different types of environments a specific development team can create . In Azure Deployment Environments Preview, [environment types](concept-environments-key-concepts.md#project-environment-types) added to the project will be available to developers when they deploy environments, and they determine the subscription and identity used for those deployments.
+Project environment types are a subset of the [environment types configured for a dev center](how-to-configure-devcenter-environment-types.md). They help preconfigure the environments that a specific development team can create. 
 
-Project environment types enable the Dev Infra teams to:
-- Configure the target subscription in which Azure resources will be created per environment type per project. 
-  You will be able to provide different subscriptions for different Environment Types in a given project and thereby, automatically apply the right set of policies on different environments. This also abstracts Azure governance related concepts from your development teams.
-- Pre-configure the managed identity that will be used to perform the deployment and the access levels development teams get after the specific environment is created.
+In Azure Deployment Environments Preview, [environment types](concept-environments-key-concepts.md#project-environment-types) that you add to the project will be available to developers when they deploy environments. Environment types determine the subscription and identity that are used for those deployments.
+
+Project environment types enable development infrastructure teams to:
+
+- Configure the target subscription in which Azure resources will be created per environment type and per project. 
+  
+  You can provide subscriptions for environment types in a project to automatically apply the right set of policies on environments. This action also abstracts Azure governance-related concepts from your development teams.
+- Preconfigure the managed identity that developers will use to perform the deployment, along with the access levels that development teams get after the environment is created.
 
 In this article, you'll learn how to:
 
-* Add a new project environment type
-* Update a project environment type
-* Enable or disable a project environment type
-* Delete a project environment type 
+* Add a new project environment type.
+* Update a project environment type.
+* Enable or disable a project environment type.
+* Delete a project environment type. 
 
 > [!IMPORTANT]
 > Azure Deployment Environments is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
 ## Prerequisites
-- A [dev center level environment type](how-to-configure-devcenter-environment-types.md).
+Before you configure a project environment type, you need:
 
-## Add a new project environment type
+- An [environment type at the dev center level](how-to-configure-devcenter-environment-types.md).
+- [Write access](/azure/devops/organizations/security/add-users-team-project) to the specific project.
 
->[!NOTE]
-> To configure project environment types, you'll need write [access](/azure/devops/organizations/security/add-users-team-project) to the specific project.
+## Add a new project environment type
 
-Configuring a new project environment type will enable your development teams to create an environment with a specific environment type. The environment will be created in the mapped subscription using the configured deployment identity, along with permissions granted to the resources created as part of the environment, and all the associated policies automatically applied.
+When you configure a new project environment type, your development teams can use it to create an environment. They'll create the environment in the mapped subscription by using the configured deployment identity, along with permissions granted to resources created as part of the environment. All the associated policies are automatically applied.
 
 Add a new project environment type as follows:
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
-1. Access Azure Deployment Environments.
-1. Select **Projects** from the left pane, and then select the specific Project.
+1. Open Azure Deployment Environments.
+1. Select **Projects** from the left pane, and then select the specific project.
 1. Select **Environment types** from the left pane.
 1. Select **+ Add**.
 
-   :::image type="content" source="./media/configure-project-environment-types/add-new-project-environment-type.png" alt-text="Screenshot showing adding a project environment type.":::
+   :::image type="content" source="./media/configure-project-environment-types/add-new-project-environment-type.png" alt-text="Screenshot that shows selections for adding a project environment type.":::
 
 1. On the **Add environment type to Project** page, provide the following details:
 
     |Name     |Value     |
     |---------|----------|
-    |**Type**| Select a dev center level environment type to enable for the specific project.|
-    |**Deployment Subscription**| Select the target subscription in which the environments will be created.|
-    |**Deployment Identity** | Select either a system assigned identity or a user assigned managed identity that'll be used to perform deployments on behalf of the user.|
-    |**Permissions on environment resources** > **Environment Creator Role(s)**|  Select the role(s) that'll get access to the environment resources.|
-    |**Permissions on environment resources** > **Additional access** | Select the user(s) or Azure Active Directory (Azure AD) group(s) that'll be granted specific role(s) on the environment resources.|
-    |**Tags** (optional) | Provide a **Name** and **Value**. These tags will be applied on all resources created as part of the environments.|
+    |**Type**| Select a dev center environment type to enable for the project.|
+    |**Deployment subscription**| Select the target subscription in which the environment will be created.|
+    |**Deployment identity** | Select either a system-assigned identity or a user-assigned managed identity that will be used to perform deployments on behalf of the user.|
+    |**Permissions on environment resources** > **Environment Creator Role(s)**|  Select the roles that will get access to the environment resources.|
+    |**Permissions on environment resources** > **Additional access** | Select the users or Azure Active Directory groups that will be granted specific roles on the environment resources.|
+    |**Tags** (optional) | Provide a name and value for tags that will be applied on all resources created as part of the environments.|
 
-   :::image type="content" source="./media/configure-project-environment-types/add-project-environment-type-page.png" alt-text="Screenshot showing adding details on the add project environment type page.":::
+   :::image type="content" source="./media/configure-project-environment-types/add-project-environment-type-page.png" alt-text="Screenshot that shows adding details on the page for adding a project environment type.":::
 
 > [!NOTE]
-> At least one identity (system assigned or user assigned) must be enabled for deployment identity and will be used to perform the environment deployment on behalf of the developer. Additionally, the identity attached to the dev center should be [granted 'Owner' access to the deployment subscription](how-to-configure-managed-identity.md) configured per environment type.
+> At least one identity (system assigned or user assigned) must be enabled for deployment identity. It will be used to perform the environment deployment on behalf of the developer. Additionally, the identity attached to the dev center should be [granted Owner access to the deployment subscription](how-to-configure-managed-identity.md) configured per environment type.
 
 ## Update a project environment type
 
-A project environment type can be updated to use a different subscription or deployment identity when deploying environments. Once the project environment type is updated, it will only affect creation of new environments. Existing environments will continue to exist in the previously mapped subscription.
+You can update a project environment type so that it uses a different subscription or deployment identity when developers deploy environments. Updating a project environment type affects only the creation of new environments. Existing environments will continue to exist in the previously mapped subscription.
 
 Update an existing project environment type as follows:
 
-1. Navigate to the Azure Deployment Environments Project.
-1. Select **Environment types** from the left pane of the specific Project.
-1. Select the environment type you want to update.
+1. In the Azure portal, open Azure Deployment Environments.
+1. Select **Projects** from the left pane, and then select the specific project.
+1. Select **Environment types** from the left pane.
+1. Select the environment type that you want to update.
 1. Select the **Edit** icon (![image](./media/configure-project-environment-types/edit-icon.png)) on the specific row.
 1. On the **Edit environment type** page, update the previous configuration, and then select **Submit**. 
 
 ## Enable or disable a project environment type
 
-A project environment type can be disabled to prevent developers from creating new environments with the specific environment type. Once a project environment type is disabled, it cannot be used to create a new environment. Existing environments are not affected.
+You can disable a project environment type to prevent developers from using it to create environments. Disabling a project environment type doesn't affect existing environments.
 
-When a disabled environment type is re-enabled, development teams will be able to create new environments with that specific environment type.
+When you enable an environment type (or re-enable one that you disabled), development teams can use it to create environments.
 
-1. Navigate to the Azure Deployment Environments project.
-1. Select **Environment types** on the left pane of the specific project.
-1. Select the specific environment type to enable or disable.
+1. In the Azure portal, open Azure Deployment Environments.
+1. Select **Projects** from the left pane, and then select the specific project.
+1. Select **Environment types** from the left pane.
+1. Select the environment type to enable or disable.
 1. Select **Enable** or **Disable** from the command bar and then confirm.
 
 ## Delete a project environment type
 
-You can delete a specific project environment type only if it is not being used by any deployed environments in the Project. Once you delete a specific project environment type, development teams will no longer be able to use it to create environments.
+You can delete a specific project environment type only if no deployed environments in the project are using it. After you delete a project environment type, development teams can't use it to create environments.
 
-1. Navigate to the Azure Deployment Environments project.
-1. Select **Environment types** from the left pane of the specific project.
+1. In the Azure portal, open Azure Deployment Environments.
+1. Select **Projects** from the left pane, and then select the specific project.
+1. Select **Environment types** from the left pane.
 1. Select a project environment type to delete.
-1. Select **Delete** from the command bar.
-1. Confirm to delete the project environment type.
+1. Select **Delete** from the command bar and then confirm.
 
 ## Next steps
 
-* Get started with [creating environments](quickstart-create-access-environments.md)
+* Get started with [creating environments](quickstart-create-access-environments.md).