edits

Author: ktoliver

articles/deployment-environments/how-to-manage-environments.md

@@ -1,7 +1,7 @@
 ---
 title: Manage your environment
 titleSuffix: Azure Deployment Environments
-description: Learn how to manage your deployment environments in the developer portal or by using the Azure CLI.
+description: Learn how to manage your Azure Deployment Environments Preview deployment environment in the developer portal or by using the Azure CLI.
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: deployment-environments
@@ -11,9 +11,9 @@ ms.date: 02/28/2023
 
 # Manage your environment
 
-In Azure Deployment Environments Preview, a dev infra admin gives developers access to projects and the environment types associated with them. Once a developer has access, they can create deployments environments based on the pre-configured environment types. The permissions that the creator of the environment and the rest of team get to the environment’s resources are defined in the specific environment type.
+In Azure Deployment Environments Preview, a development infrastructure (dev infra) admin gives developers access to projects and the environment types that are associated with them. After a developer has access, they can create deployments environments based on the pre-configured environment types. The permissions that the creator of the environment and the rest of team have to access the environment’s resources are defined in the specific environment type.
 
-As a developer, you can create and manage your environments from the developer portal or from the Azure CLI.  
+As a developer, you can create and manage your environments from the developer portal or by using the Azure CLI.  
 
 ## Prerequisites
 
@@ -22,33 +22,33 @@ As a developer, you can create and manage your environments from the developer p
 
 ## Manage an environment by using the developer portal
 
-The developer portal provides a graphical interface for the development teams to create new environments and manage existing environments. You can create, redeploy, and delete your environments as needed.
+The developer portal provides a graphical interface for development teams to create new environments and manage existing environments. You can create, redeploy, and delete your environments as needed in the developer portal.
 
 ### Create an environment by using the developer portal
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
-1. From the **New** menu at the top right, select **New environment**.
+1. On the **New** menu at the top right, select **New environment**.
 
    :::image type="content" source="media/how-to-manage-environments/new-environment.png" alt-text="Screenshot showing the new menu with new environment highlighted.":::
 
-1. In the Add an environment pane, select the following information:
+1. In the **Add an environment** pane, enter or select the following information:
 
    |Field  |Value  |
    |---------|---------|
    |Name     | Enter a descriptive name for your environment. |
    |Project  | Select the project you want to create the environment in. If you have access to more than one project, you see a list of the available projects. |
    |Type     | Select the environment type you want to create. If you have access to more than one environment type, you see a list of the available types. |
-   |Catalog item | Select the catalog item you want to use to create the environment. You see a list of the catalog items available from the catalogs associated with your dev center. |
+   |Catalog item | Select the catalog item you want to use to create the environment. You see a list of the catalog items available in the catalogs associated with your dev center. |
 
-   :::image type="content" source="media/how-to-manage-environments/add-environment.png" alt-text="Screenshot showing add environment pane.":::
+   :::image type="content" source="media/how-to-manage-environments/add-environment.png" alt-text="Screenshot showing the add environment pane.":::
 
-   If parameters are defined on the catalog item, you're prompted to enter them on a separate pane. If your environment doesn't use parameters, select Create.
+   If parameters are defined on the catalog item, you're prompted to enter them in a separate pane. If your environment doesn't use parameters, select **Create**.
 
    :::image type="content" source="media/how-to-manage-environments/parameter-pane.png" alt-text="Screenshot showing the parameter pane.":::
 
-1. Select **Create**. You see the environment tile in the developer portal immediately, displaying the **Creating...** status while creation is in progress.
+1. Select **Create**. The environment tile is shown in the developer portal immediately, displaying the **Creating...** status while creation is in progress.
 
-1. To view the resources created for the environment, select **Environment Resources**.
+1. To view the resources that were created for the environment, select **Environment Resources**.
 
    :::image type="content" source="media/how-to-manage-environments/environment-resources-link.png" alt-text="Screenshot showing an environment tile with the Environment Resources link highlighted. ":::
 
@@ -62,23 +62,21 @@ When you need to update your environment, you can redeploy it. The redeployment
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
 
-1. On the environment you want to redeploy, from the options menu, select **Redeploy**.
+1. On the environment you want to redeploy, on the options menu, select **Redeploy**.
 
    :::image type="content" source="media/how-to-manage-environments/option-redeploy.png" alt-text="Screenshot showing an environment tile with the options menu expanded and the redeploy option selected.":::
 
-1. If parameters are defined on the catalog item, you're prompted to make any changes you want. When you've made your changes, select **Redeploy**.
+1. If parameters are defined on the catalog item, you're prompted to make any changes you want to make. When you've made your changes, select **Redeploy**.
 
    :::image type="content" source="media/how-to-manage-environments/redeploy-parameters.png" alt-text="Screenshot showing the redeploy parameters pane.":::
 
-1. If your environment doesn't include configurable parameters, you see the Redeploy *environment name* message. Select **Redeploy**.
+1. If your environment doesn't include configurable parameters, you see the **Redeploy \<environment name\>** message. Select **Redeploy**.
 
-   :::image type="content" source="media/how-to-manage-environments/confirm-redeploy.png" alt-text="Screenshot showing redeploy confirmation message with redeploy highlighted.":::
+   :::image type="content" source="media/how-to-manage-environments/confirm-redeploy.png" alt-text="Screenshot showing the redeploy confirmation message with redeploy highlighted.":::
 
-1. The environment displays the **Redeploying...** status while the redeployment takes place.
+1. The environment displays the **Redeploying...** status while the redeployment takes place. To view the redeployed resources, select **Environment Resources**.
 
-1. To view the redeployed resources, select **Environment Resources**.
-
-1. The environment resources are displayed in the Azure portal.
+   The environment resources are displayed in the Azure portal.
 
    :::image type="content" source="media/how-to-manage-environments/redeployed-resources.png" alt-text="Screenshot showing redeployed resources in the Azure portal.":::
 
@@ -88,7 +86,7 @@ You can delete your environment completely when you don't need it anymore.
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
 
-1. On the environment you want to redeploy, from the options menu, select **Delete**.
+1. On the environment you want to redeploy, on the options menu, select **Delete**.
 
    :::image type="content" source="media/how-to-manage-environments/option-delete.png" alt-text="Screenshot showing an environment tile with the options menu expanded and the delete option selected.":::
 
@@ -102,7 +100,7 @@ You can delete your environment completely when you don't need it anymore.
 
 The Azure CLI provides a command-line interface for speed and efficiency when you create multiple similar environments, or for platforms where resources like memory are limited. You can use the following commands to create, list, deploy, or delete an environment.
 
-To learn how to Deployment Environments Azure CLI extension, see [Configure Azure Deployment Environments service using Azure CLI](how-to-configure-use-cli.md).
+To learn how to Deployment Environments Azure CLI extension, see [Configure Azure Deployment Environments by using the Azure CLI](how-to-configure-use-cli.md).
 
 ### Create an environment
 
@@ -134,5 +132,5 @@ az devcenter dev environment delete --dev-center-name <devcenter-name>  --projec
 
 ## Next steps
 
-- Learn about configuring Azure Deployment Environments: [Quickstart: Create and configure a dev center](quickstart-create-and-configure-devcenter.md)
-- Learn more about managing your environments with the CLI: [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md)
+- Learn how to configure Azure Deployment Environments: [Quickstart: Create and configure a dev center](quickstart-create-and-configure-devcenter.md).
+- Learn more about managing your environments by using the CLI: [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md).