updates

Author: v-albemi

articles/deployment-environments/quickstart-create-dev-center-project-azure-resource-manager.md

@@ -11,7 +11,7 @@ ms.date: 07/28/2025
 # Customer intent: As an enterprise admin, I want to use an ARM template to create and configure a dev center and project so that I can evaluate Deployment Environments.
 ---
 
-# Quickstart: Create dev center and project for Azure Deployment Environments by using an ARM template
+# Quickstart: Create a dev center and project for Azure Deployment Environments by using an ARM template
 
 This quickstart describes how to use an Azure Resource Manager template (ARM template) to create and configure a dev center and project for creating an environment.
 
@@ -24,36 +24,36 @@ If your environment meets the prerequisites and you're familiar with using ARM t
 
 ## Prerequisites
 
-- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+- An Azure subscription. Create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) if you don't have one.
 - Owner or Contributor role on an Azure subscription or resource group.
-- Microsoft Entra AD. Your organization must use Microsoft Entra AD for identity and access management.
-- Microsoft Intune subscription. Your organization must use Microsoft Intune for device management.
+- Microsoft Entra ID. Your organization must use Microsoft Entra ID for identity and access management.
+- A Microsoft Intune subscription. Your organization must use Intune for device management.
 
 ## Review the template
 
-The template used in this quickStart is from [Azure Quickstart Templates](/samples/azure/azure-quickstart-templates/deployment-environments/).
+The template used in this quickstart is from [Azure Quickstart Templates](/samples/azure/azure-quickstart-templates/deployment-environments/).
 
 To view the template, see [azuredeploy.json](https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json).
 
 Azure resources defined in the template:
 
-- [Microsoft.DevCenter/devcenters](/azure/templates/microsoft.devcenter/devcenters): create a dev center.
-- [Microsoft.DevCenter/devcenters/catalogs](/azure/templates/microsoft.devcenter/devcenters/catalogs): create a catalog.
-- [Microsoft.DevCenter/devcenters/environmentTypes](/azure/templates/microsoft.devcenter/devcenters/environmenttypes): create a dev center environment type.
-- [Microsoft.DevCenter/projects](/azure/templates/microsoft.devcenter/projects): create a project.
-- [Microsoft.Authorization/roleAssignments](/azure/templates/microsoft.authorization/roleassignments): create a role assignment.
-- [Microsoft.DevCenter/projects/environmentTypes](/azure/templates/microsoft.devcenter/projects/environmenttypes): create a project environment type.
+- [Microsoft.DevCenter/devcenters](/azure/templates/microsoft.devcenter/devcenters). Create a dev center.
+- [Microsoft.DevCenter/devcenters/catalogs](/azure/templates/microsoft.devcenter/devcenters/catalogs). Create a catalog.
+- [Microsoft.DevCenter/devcenters/environmentTypes](/azure/templates/microsoft.devcenter/devcenters/environmenttypes). Create a dev center environment type.
+- [Microsoft.DevCenter/projects](/azure/templates/microsoft.devcenter/projects). Create a project.
+- [Microsoft.Authorization/roleAssignments](/azure/templates/microsoft.authorization/roleassignments). Create a role assignment.
+- [Microsoft.DevCenter/projects/environmentTypes](/azure/templates/microsoft.devcenter/projects/environmenttypes). Create a project environment type.
 
 ## Deploy the template
 
-1. Select **Open Cloud Shell** on either of the following code blocks and follow instructions to sign in to Azure.
-2. Wait until you see the prompt from the console, then ensure you're set to deploy to the subscription you want.
-3. If you want to continue deploying the template, select **Copy** on the code block, then right-click the shell console and select **Paste**.
+1. Select **Open Cloud Shell** above either of the following code blocks and follow the instructions to sign in to Azure.
+1. When you see the prompt from the console, ensure that you're ready to deploy to your chosen subscription.
+1. If you want to continue deploying the template, select **Copy** on the code block, and then right-click the shell console and select **Paste**.
 
-   1. If you want to use the default parameter values:
+   - If you want to use the default parameter values, use this code:
 
       ```azurepowershell-interactive
-      $location = Read-Host "Please enter region name e.g. eastus"
+      $location = Read-Host "Please enter region name, for example, eastus"
       $templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
 
       Write-Host "Start provisioning..."
@@ -64,16 +64,16 @@ Azure resources defined in the template:
 
       ```
 
-   2. If you want to input your own values:
+   - If you want to input your own values, use this code:
 
       ```azurepowershell-interactive
       $resourceGroupName = Read-Host "Please enter resource group name: "
       $devCenterName = Read-Host "Please enter dev center name: "
       $projectName = Read-Host "Please enter project name: "
       $environmentTypeName = Read-Host "Please enter environment type name: "
-      $userObjectId = Read-Host "Please enter your user object ID e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+      $userObjectId = Read-Host "Please enter your user object ID, for example, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 
-      $location = Read-Host "Please enter region name e.g. eastus"
+      $location = Read-Host "Please enter region name, for example, eastus"
       $templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
 
       Write-Host "Start provisioning..."
@@ -90,31 +90,33 @@ Azure PowerShell is used to deploy the template. You can also use the Azure port
 
 ### Required parameters
 
-- *Resource Group Name*: The name of the resource group where the dev center and project are located.
-- *Dev Center Name*: The name of the dev center.
-- *Project Name*: The name of the project that is associated with the dev center.
-- *Environment Type Name*: The name of the environment type for both the dev center and project.
-- *User Object ID*: The object ID of the user that is granted the *Deployment Environments User* role.
+- *Resource group name*: The name of the resource group where the dev center and project will be located.
+- *Dev center name*: The name of the dev center.
+- *Project name*: The name of the project that's associated with the dev center.
+- *Environment type name*: The name of the environment type for both the dev center and the project.
+- *User object ID*: The object ID of a user that's granted the *Deployment Environments User* role.
 
-Alternatively, you can provide access to deployment environments project in the Azure portal. See [Provide user access to Azure Deployment Environments projects](./how-to-configure-deployment-environments-user.md).
+Alternatively, you can provide access to the deployment environments project in the Azure portal. See [Provide user access to Azure Deployment Environments projects](./how-to-configure-deployment-environments-user.md).
 
 ## Review deployed resources
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Select **Resource groups** from the left pane. 
-3. Select the resource group that you created in the previous section.  
+1. Select **Resource groups** in the left pane. 
+1. Select the resource group that you created in the previous section.  
 
 ## Clean up resources
 
-1. Delete any environments associated with the project either through the Azure portal or the developer portal.
-2. Delete the project resource.
-3. Delete the dev center resource.
-4. Delete the resource group.
-5. Remove the role assignments that you don't need anymore from the subscription.
+If you no longer need the resources you created, delete them by following these instructions:
 
-## Next steps
+1. Delete any environments that are associated with the project by using the Azure portal or the developer portal.
+1. Delete the project resource.
+1. Delete the dev center resource.
+1. Delete the resource group.
+1. Remove role assignments that you don't need anymore from the subscription.
 
-In this quickstart, you created and configured a dev center and project. Advance to the next quickstart to learn how to create an environment.
+## Next step
+
+In this quickstart, you created and configured a dev center and project. Go to the next quickstart to learn how to create an environment.
 
 > [!div class="nextstepaction"]
 > [Quickstart: Create and access an environment](./quickstart-create-access-environments.md)