Merge pull request #303114 from v-albemi/create-access-environments

Freshness Edit: Azure Deployment Environments

Author: AnnaMHuff

articles/deployment-environments/includes/developer-portal-landing-page.md

@@ -8,18 +8,18 @@ ms.service: dev-box
 
 1. Go to the [developer portal](https://aka.ms/devbox-portal). The landing page contains useful information and links. When you're ready, select **Sign in**. 
 
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-landing-page-sign-in.png" alt-text="Screenshot of the developer portal landing page with sign-in highlighted.":::
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-landing-page-sign-in.png" alt-text="Screenshot of the developer portal landing page. Sign in is highlighted.":::
 
 #### [No existing environments](#tab/no-existing-environments)
 
 2. If you don't have any dev boxes, you see this screen. Select **New environment**.
 
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-deployment-environment.png" alt-text="Screenshot of the developer portal with new environment highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-deployment-environment.png":::
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-deployment-environment.png" alt-text="Screenshot of the developer portal. New environment is highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-deployment-environment.png":::
 
 #### [Existing environments](#tab/existing-environments)
 
 2. Select **New** > **New environment**.
 
-   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-environment-menu.png" alt-text="Screenshot of the developer portal with the New menu and Dev box option highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-environment-menu.png":::
+   :::image type="content" source="../media/developer-portal-landing-page/developer-portal-new-environment-menu.png" alt-text="Screenshot of the developer portal. The New and New environment options are highlighted." lightbox="../media/developer-portal-landing-page/developer-portal-new-environment-menu.png":::
 
 ---

articles/deployment-environments/media/quickstart-create-access-environments/azure-portal-view-of-environment.png

@@ -1,63 +1,64 @@
 ---
-title: Create a deployment environment
+title: Create a Deployment Environment
 titleSuffix: Azure Deployment Environments
-description: Learn how to create and access an environment in Azure Deployment Environments through the developer portal. An environment has all Azure resource preconfigured for deploying your application.
+description: Learn how to create and access an environment in Azure Deployment Environments by using the developer portal. 
 author: RoseHJM
 ms.author: rosemalcolm
 ms.service: azure-deployment-environments
 ms.custom: build-2023
 ms.topic: quickstart
-ms.date: 12/01/2023
+ms.date: 07/24/2025
+
+#customer intent: As a developer, I want to create and acess an environment so that I can use preconfigured Azure resources to deploy an application.
 ---
 
 # Quickstart: Create and access an environment in Azure Deployment Environments
 
-This quickstart shows you how to create and access an [environment](concept-environments-key-concepts.md#environments) in Azure Deployment Environments by using the developer portal.
+This quickstart describes how to create and access an [environment](concept-environments-key-concepts.md#environments) in Azure Deployment Environments by using the developer portal.
 
-As a developer, you can create environments associated with a [project](concept-environments-key-concepts.md#projects) in Azure Deployment Environments. An environment has all Azure resource preconfigured for deploying your application.
+As a developer, you can create environments associated with a [project](concept-environments-key-concepts.md#projects) in Deployment Environments. An environment provides preconfigured Azure resources for deploying your application.
 
 ## Prerequisites
 
-- Your organization must configure Azure Deployment Environments with a dev center and at least one project before you can create a deployment environment.
-    - Platform engineers can follow these steps to configure [Quickstart: Configure Azure Deployment Environments](quickstart-create-and-configure-devcenter.md).
-- You must have permissions as a Deployment Environments User for a project. If you don't have permissions to a project, contact your administrator.
+- Someone in your organization must configure Deployment Environments with a dev center and at least one project before you can create a deployment environment. To meet this prerequisite, platform engineers can complete the steps in [Quickstart: Configure Azure Deployment Environments](quickstart-create-and-configure-devcenter.md).
+- You must have permissions as a Deployment Environments User for a project. If you don't have permissions for a project, contact your administrator.
 
 ## Create an environment
 
-An environment in Azure Deployment Environments is a collection of Azure resources on which your application is deployed. You can create an environment from the developer portal.
+An environment in Deployment Environments is a collection of Azure resources on which your application is deployed. You can create an environment from the developer portal.
 
 [!INCLUDE [note-deployment-environments-user](includes/note-deployment-environments-user.md)]
 
 [!INCLUDE [developer-portal-landing-page](includes/developer-portal-landing-page.md)]
 
-3. In the **Add an environment** pane, select the following information:
+3. 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 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 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 from the catalogs associated with your dev center. |
+   |**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 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 available types. |
+   |**Definition** | Select the environment definition you want to use to create the environment. You see a list of the environment definitions that are available from the catalogs associated with your dev center. |
 
-   :::image type="content" source="media/quickstart-create-access-environments/dev-add-environment.png" alt-text="Screenshot showing add environment pane." lightbox="media/quickstart-create-access-environments/dev-add-environment-expanded.png":::
+   :::image type="content" source="media/quickstart-create-access-environments/dev-add-environment.png" alt-text="Screenshot showing the Add an environment pane.":::
 
    If your environment is configured to accept parameters, you can enter them on a separate pane. In this example, you don't need to specify any parameters.
 
-4. Select **Create**. You see your environment in the developer portal immediately, with an indicator that shows creation in progress.
+4. Select **Create**. You see your environment in the developer portal immediately. An indicator shows the progress of the environment creation.
 
 ## Access an environment
 
-You can access and manage your environments in the Azure Deployment Environments developer portal.
+You can access and manage your environments in the Deployment Environments developer portal.
 
 1. Sign in to the [developer portal](https://devportal.microsoft.com).
 
-1. You can view all of your existing environments. To access the specific resources created as part of an environment, select the **Environment Resources** link.
+1. You can view all of your existing environments. To access the resources created as part of an environment, select **View resources**.
 
-   :::image type="content" source="media/quickstart-create-access-environments/dev-environment-resources.png" alt-text="Screenshot showing an environment card, with the environment resources link highlighted." lightbox="media/quickstart-create-access-environments/dev-environment-resources-expanded.png":::
+   :::image type="content" source="media/quickstart-create-access-environments/dev-environment-resources.png" alt-text="Screenshot showing an environment card. The View resources link is highlighted.":::
 
-1. You can view the resources in your environment listed in the Azure portal.
+1. You can view the resources in your environment in the Azure portal:
 
-   :::image type="content" source="media/quickstart-create-access-environments/azure-portal-view-of-environment.png" alt-text="Screenshot showing Azure portal list of environment resources." lightbox="media/quickstart-create-access-environments/azure-portal-view-of-environment.png":::
+   :::image type="content" source="media/quickstart-create-access-environments/azure-portal-view-of-environment.png" alt-text="Screenshot showing the list of environment resources." lightbox="media/quickstart-create-access-environments/azure-portal-view-of-environment.png":::
 
    Creating an environment automatically creates a resource group that stores the environment's resources. The resource group name follows the pattern `{projectName}-{environmentName}`. You can view the resource group in the Azure portal.