Merge pull request #260683 from cdpark/refresh-devcenter-how-to

Freshness pass 167585: Azure Deployment Environments -- How to articles

Author: AnnaMHuff

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

@@ -7,14 +7,14 @@ ms.author: rosemalcolm
 ms.service: deployment-environments
 ms.custom: devx-track-azurecli, build-2023
 ms.topic: how-to
-ms.date: 10/06/2023
+ms.date: 12/07/2023
 ---
 
 # Manage environments in Azure Deployment Environments
 
 In this article, you learn how to manage environments in Azure Deployment Environments. As a developer, you can create and manage your environments from the developer portal or by using the Azure CLI.
 
-In Azure Deployment Environments, a platform engineer gives developers access to projects and the environment types that are associated with them. After a developer has access, they can create deployment environments based on the preconfigured 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.  
+In Azure Deployment Environments, a platform engineer gives developers access to projects and the environment types that are associated with them. After a developer has access, they can create deployment environments based on the preconfigured environment types. The permissions are defined in the specific environment type.  
 
 ## Prerequisites
 
@@ -28,9 +28,10 @@ The developer portal provides a graphical interface for development teams to cre
 ### Create an environment by using the developer portal
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
+
 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.":::
+   :::image type="content" source="media/how-to-manage-environments/new-environment.png" alt-text="Screenshot showing the new menu with new environment highlighted." lightbox="media/how-to-manage-environments/new-environment.png":::
 
 1. In the **Add an environment** pane, enter or select the following information:
 
@@ -41,69 +42,69 @@ The developer portal provides a graphical interface for development teams to cre
    |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. |
    |Environment definitions | Select the environment definition you want to use to create the environment. You see a list of the environment definitions 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 the add environment pane.":::
+   :::image type="content" source="media/how-to-manage-environments/add-environment.png" alt-text="Screenshot showing the add environment pane." lightbox="media/how-to-manage-environments/add-environment.png":::
 
-   If parameters are defined on the environment definition, you're prompted to enter them in a separate pane. If your environment doesn't use parameters, select **Create**.
+   If your environment is configured to accept parameters, you can enter them on a separate pane.
 
-   :::image type="content" source="media/how-to-manage-environments/parameter-pane.png" alt-text="Screenshot showing the parameter pane.":::
+   :::image type="content" source="media/how-to-manage-environments/parameter-pane.png" alt-text="Screenshot showing the parameter pane." lightbox="media/how-to-manage-environments/parameter-pane.png":::
 
 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 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. ":::
+   :::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." lightbox="media/how-to-manage-environments/environment-resources-link.png":::
 
-1. The environment resources are displayed in the Azure portal.
+1. You can view the resources in your environment listed in the Azure portal.
 
-   :::image type="content" source="media/how-to-manage-environments/environment-resources.png" alt-text="Screenshot showing environment resources in the Azure portal.":::
+   :::image type="content" source="media/how-to-manage-environments/environment-resources.png" alt-text="Screenshot showing environment resources in the Azure portal." lightbox="media/how-to-manage-environments/environment-resources.png":::
 
 ### Redeploy an environment by using the developer portal
 
 When you need to update your environment, you can redeploy it. The redeployment process updates any existing resources with changed properties or creates any new resources based on the latest configuration of the environment definition.
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
 
-1. On the environment you want to redeploy, on the options menu, select **Redeploy**.
+1. On the environment you want to redeploy, select the options menu next to the environment name, then choose **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.":::
+   :::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." lightbox="media/how-to-manage-environments/option-redeploy.png":::
 
-1. If parameters are defined on the environment definition, you're prompted to make any changes you want to make. When you've made your changes, select **Redeploy**.
+1. If parameters are defined on the environment definition, you're prompted to make any changes you want to make. After you make your changes, select **Redeploy**.
 
-   :::image type="content" source="media/how-to-manage-environments/redeploy-parameters.png" alt-text="Screenshot showing the redeploy parameters pane.":::
+   :::image type="content" source="media/how-to-manage-environments/redeploy-parameters.png" alt-text="Screenshot showing the redeploy parameters pane." lightbox="media/how-to-manage-environments/redeploy-parameters.png":::
 
 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 the 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." lightbox="media/how-to-manage-environments/confirm-redeploy.png":::
 
 1. The environment displays the **Redeploying...** status while the redeployment takes place. To view the redeployed resources, select **Environment Resources**.
 
    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.":::
+   :::image type="content" source="media/how-to-manage-environments/redeployed-resources.png" alt-text="Screenshot showing redeployed resources in the Azure portal." lightbox="media/how-to-manage-environments/redeployed-resources.png":::
 
 ### Delete an environment by using the developer portal
 
 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, on the options menu, select **Delete**.
+1. On the environment you want to redeploy, select the options menu next to the environment name, then choose **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.":::
+   :::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." lightbox="media/how-to-manage-environments/option-delete.png":::
 
 1. In the confirmation message, select **Delete**
 
-   :::image type="content" source="media/how-to-manage-environments/confirm-delete.png" alt-text="Screenshot showing a confirm deletion message with Delete highlighted.":::
+   :::image type="content" source="media/how-to-manage-environments/confirm-delete.png" alt-text="Screenshot showing a confirm deletion message with Delete highlighted." lightbox="media/how-to-manage-environments/confirm-delete.png":::
 
 1. The environment tile displays the status **Deleting...** while the deletion is in progress.
 
 ## Manage an environment by using the Azure CLI
 
-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 `devcenter` Azure CLI extension to create, list, deploy, or delete an environment in Azure Deployment Environments.
+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 *devcenter* Azure CLI extension to create, list, deploy, or delete an environment in Azure Deployment Environments.
 
 To learn how to manage your environments by using the CLI, see [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md).
 
-For reference documentation on the  `devcenter` Azure CLI extension, see [az devcenter](https://aka.ms/CLI-reference).
+For reference documentation about the *devcenter* Azure CLI extension, see [az devcenter](https://aka.ms/CLI-reference).
 
 ## Related content
 

articles/deployment-environments/how-to-request-quota-increase.md

@@ -6,16 +6,16 @@ ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
 ms.topic: how-to
-ms.date: 09/27/2023
+ms.date: 12/07/2023
 ---
 
 # Request a quota limit increase for Azure Deployment Environments resources
 
-This article describes how to submit a support request for increasing the number of resources available to Azure Deployment Environments in your Azure subscription. 
+This guide explains how to submit a support request to increase the number of resources available to Azure Deployment Environments in your Azure subscription.
 
-If your organization uses Deployment Environments extensively, you may encounter a quota limit during deployment. When you reach the limit for a resource in your subscription, you can request a limit increase (sometimes called a capacity increase, or a quota increase) to extend the number of resources available. The request process allows the Azure Deployment Environments team to ensure that your subscription isn't involved in any cases of fraud or unintentional, sudden large-scale deployments. 
+If your organization uses Deployment Environments extensively, you might encounter a quota limit during deployment. When you reach the limit for a resource in your subscription, you can request a limit increase (sometimes called a capacity increase or a quota increase) to extend the number of resources available. The request process allows the Azure Deployment Environments team to ensure that your subscription isn't involved in any cases of fraud or unintentional, sudden large-scale deployments. 
 
-Learn more about the general [process for creating Azure support requests](../azure-portal/supportability/how-to-create-azure-support-request.md).
+To learn more about the general process for creating Azure support requests, see [Create an Azure support request](../azure-portal/supportability/how-to-create-azure-support-request.md).
 
 ## Prerequisites
 
@@ -24,30 +24,28 @@ Learn more about the general [process for creating Azure support requests](../az
 
 ## Gather information for your request
 
-Submitting a support request for additional quota is quicker if you gather the required information before you begin the request process. 
+Submitting a support request to increase your quota is quicker if you gather the required information before you begin the request process. 
 
 - **Identify the quota type**
 
    If you reach the quota limit for a Deployment Environments resource, you see a notification indicating which quota type is affected during deployment. Take note of it and submit a request for that quota type.
-   
-   The following resources are limited by subscription.  
 
+   The following resources are limited by subscription: 
    - Runtime limit per month (mins)
    - Runtime limit per deployment (mins)
    - Storage limit per environment (GBs)
 
+- **Determine the region for the quota increase**
 
-- **Determine the region for the additional quota**
-
-   Deployment Environments resources can exist in many regions. You should choose the region where your Deployment Environments Project exists for best performance. 
+   Deployment Environments resources can exist in many regions. For best performance, you should choose the region where your Deployment Environments project exists.
 
    For more information about Azure regions, how they relate to global geographies, and which services are available in each region, see [Azure global infrastructure](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/).
 
 ## Submit a new support request
 
 Follow these steps to request a limit increase:  
 
-1. On the Azure portal home page, select Support & troubleshooting, and then select  **Help + support**
+1. Sign in to the [Azure portal](https://portal.azure.com), select Support & troubleshooting from the menu bar, and then choose **Help + support**. If this option doesn't appear, enter *Help + support* in the search bar.
 
     :::image type="content" source="./media/how-to-request-capacity-increase/submit-new-request.png" alt-text="Screenshot of the Azure portal home page, highlighting the Request core limit increase button." lightbox="./media/how-to-request-capacity-increase/submit-new-request.png":::
 
@@ -79,11 +77,12 @@ Follow these steps to request a limit increase:
     :::image type="content" source="media/how-to-request-capacity-increase/quota-details.png" alt-text="Screenshot of the Quota details pane." lightbox="media/how-to-request-capacity-increase/quota-details.png":::
 
 1. Select **Save and continue**.
+
 ## Complete the support request
 
 To complete the support request, enter the following information:
 
-1. Complete the remainder of the support request **Additional details** tab using the following information:
+1. Complete the remainder of the **Additional details** tab by using the following information:
 
    ### Advanced diagnostic information
 
@@ -116,7 +115,7 @@ To complete the support request, enter the following information:
 1. Select **Next**.
 
 1. On the **Review + create** tab, review the information, and then select **Create**.
- 
+
 ## Related content
 
 - Check the default quota for each resource type by subscription type: [Azure Deployment Environments limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-deployment-environments-limits)