Merge pull request #296546 from v-albemi/create-project

Freshness Edit: Azure Deployment Environments Set 2

Author: prmerger-automator[bot]

articles/deployment-environments/how-to-create-configure-projects.md

@@ -1,25 +1,30 @@
 ---
-title: Create and configure a project by using the Azure CLI
+title: Create and configure a project by using Azure CLI
 titleSuffix: Azure Deployment Environments
-description: Learn how to create a project in Azure Deployment Environments and associate the project with a dev center using the Azure CLI.
+description: Learn how to use Azure CLI to create a project in Azure Deployment Environments and associate the project with a dev center.
 author: renato-marciano
 ms.author: remarcia
 ms.service: azure-deployment-environments
 ms.custom: devx-track-azurecli, build-2023
 ms.topic: quickstart
-ms.date: 11/29/2023
+ms.date: 03/19/2025
+
+#customer intent: As a platform engineer, I want to create a project in Azure Deployment Environments so that my teams can deploy applications.
 ---
 
-# Create and configure a project by using the Azure CLI
+# Create and configure a project by using Azure CLI
 
-This quickstart guide shows you how to create a project in Azure Deployment Environments. Then, you associate the project with the dev center you created in [Create and configure a dev center by using the Azure CLI](how-to-create-configure-dev-center.md).
+In this quickstart, you create a project in Azure Deployment Environments. You then associate the project with the dev center you created in [Create and configure a dev center by using the Azure CLI](how-to-create-configure-dev-center.md).
 
 A platform engineering team typically creates projects and provides project access to development teams. Development teams then create [environments](concept-environments-key-concepts.md#environments) by using [environment definitions](concept-environments-key-concepts.md#environment-definitions), connect to individual resources, and deploy applications.
 
 ## Prerequisites
 
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- Azure role-based access control role with permissions to create and manage resources in the subscription, such as [Contributor](../role-based-access-control/built-in-roles.md#contributor) or [Owner](../role-based-access-control/built-in-roles.md#owner).
+|Category|Requirement|
+|-|-|
+|**Subcription**|An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).|
+|**Permissions**| Azure role-based access control role with permissions to create and manage resources in the subscription, such as [Contributor](../role-based-access-control/built-in-roles.md#contributor) or [Owner](../role-based-access-control/built-in-roles.md#owner).|
+|**Resource**|- A [dev center](how-to-create-configure-dev-center.md).|
 
 ## Create a project
 
@@ -31,7 +36,7 @@ To create a project in your dev center:
     az login
     ```
 
-1. Install the Azure CLI *devcenter* extension.
+1. Install the Azure CLI *devcenter* extension:
 
    ```azurecli
    az extension add --name devcenter --upgrade
@@ -49,20 +54,20 @@ To create a project in your dev center:
    az configure --defaults group=<resourceGroupName>
    ```
 
-1. Configure the default location as the location where your dev center resides. Location of project must match the location of dev center:
+1. Configure the default location as the location where your dev center resides. The location of the project must match the location of the dev center.
 
    ```azurecli
    az configure --defaults location=eastus
    ```
 
-1. Retrieve dev center resource ID:
+1. Retrieve the dev center resource ID:
 
     ```azurecli
     DEVCID=$(az devcenter admin devcenter show -n <devcenterName> --query id -o tsv)
     echo $DEVCID
     ```
 
-1. Create project in dev center:
+1. Create the project in the dev center:
 
     ```azurecli
     az devcenter admin project create -n <projectName> \
@@ -82,14 +87,14 @@ Before you can create environment types, you must give the managed identity that
 
 In this quickstart, you assign the Owner role to the system-assigned managed identity that you configured previously: [Attach a system-assigned managed identity](quickstart-create-and-configure-devcenter.md#attach-a-system-assigned-managed-identity).
 
-1. Retrieve Subscription ID:
+1. Retrieve the subscription ID:
 
     ```azurecli
     SUBID=$(az account show --name <subscriptionName> --query id -o tsv)
     echo $SUBID
     ```
 
-1. Retrieve the Object ID of the dev center's identity using the name of the dev center resource:
+1. Retrieve the object ID of the dev center's identity by using the name of the dev center resource:
 
     ```azurecli
     OID=$(az ad sp list --display-name <devcenterName> --query [].id -o tsv)
@@ -108,20 +113,20 @@ In this quickstart, you assign the Owner role to the system-assigned managed ide
 
 To configure a project, add a [project environment type](how-to-configure-project-environment-types.md):
 
-1. Retrieve the Role ID for the Owner of the subscription:
+1. Retrieve the role ID for the owner of the subscription:
 
     ```azurecli
-    # Remove group default scope for next command. Leave blank for group.
+    # Remove the group default scope for next the command. 
     az configure --defaults group=
 
     ROID=$(az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv)
     echo $ROID
 
-    # Set default resource group again
+    # Set the default resource group again.
     az configure --defaults group=<resourceGroupName>
     ```
 
-1. Show allowed environment type for the project:
+1. Show allowed environment types for the project:
 
     ```azurecli
     az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name
@@ -145,7 +150,7 @@ To configure a project, add a [project environment type](how-to-configure-projec
 
 In this quickstart, you give access to your own ID. Optionally, you can replace the value of `--assignee` for the following commands with another member's object ID.
 
-1. Retrieve your own Object ID:
+1. Retrieve your own object ID:
 
     ```azurecli
     MYOID=$(az ad signed-in-user show --query id -o tsv)
@@ -171,9 +176,9 @@ In this quickstart, you give access to your own ID. Optionally, you can replace
 
 [!INCLUDE [note-deployment-environments-user](includes/note-deployment-environments-user.md)]
 
-## Next steps
+## Next step
 
-In this quickstart, you created a project and granted project access to your development team. To learn how your development team members can create environments, advance to the next quickstart.
+In this quickstart, you created a project and granted project access to your development team. To learn how your development team members can create environments, go to the next quickstart:
 
 > [!div class="nextstepaction"]
 > [Create and access an environment by using the Azure CLI](how-to-create-access-environments.md)