copy edit

Author: tfitzmac

articles/azure-resource-manager/templates/template-specs-create-portal-forms.md

@@ -1,9 +1,9 @@
 ---
 title: Create portal forms for template spec
-description: Learn how to create forms that are displayed in the Azure portal forms. Use the form to deploying a template spec
+description: Learn how to create forms that are displayed in the Azure portal forms. Use the form to deploy a template spec.
 ms.topic: tutorial
 ms.custom: devx-track-azurepowershell, devx-track-azurecli
-ms.date: 03/20/2024
+ms.date: 01/30/2025
 ---
 
 # Tutorial: Create Azure portal forms for a template spec
@@ -24,9 +24,9 @@ For Azure PowerShell, use [version 6.0.0 or later](/powershell/azure/install-azu
 
 ## Create template
 
-To show the different portal elements that are available in a form, you'll use an ARM template with several parameters. The following template creates a key vault, configures permissions to key vault for a user, and adds a secret.
+To show the different portal elements that are available in a form, use an ARM template with several parameters. The following template creates a key vault, configures permissions to key vault for a user, and adds a secret.
 
-Copy this file and save it locally. This tutorial assumes you've named it **keyvault.json** but you can give it any name.
+Copy this file and save it locally. This tutorial assumes you named it **keyvault.json** but you can give it any name.
 
 ```json
 {
@@ -182,15 +182,15 @@ Copy this file and save it locally. This tutorial assumes you've named it **keyv
 
 ## Create default form
 
-The Azure portal provides a sandbox for creating and previewing forms. This sandbox can render a form from an existing ARM template. You'll use this default form to get started with creating a form for your template spec. For more information about the form structure, see [FormViewType](https://github.com/Azure/portaldocs/blob/main/portal-sdk/generated/dx-view-formViewType.md).
+The Azure portal provides a sandbox for creating and previewing forms. This sandbox can render a form from an existing ARM template. Use this default form to get started with creating a form for your template spec. For more information about the form structure, see [FormViewType](https://github.com/Azure/portaldocs/blob/main/portal-sdk/generated/dx-view-formViewType.md).
 
-1. Open the [Form view sandbox](https://aka.ms/form/sandbox).
+1. Open the [Form view sandbox](https://also known as.ms/form/sandbox).
 
     :::image type="content" source="./media/template-specs-create-portal-forms/deploy-template-spec-config.png" alt-text="Screenshot of Azure portal form view sandbox interface.":::
 
-1. In **Package Type**, select **CustomTemplate**. Make sure you select the package type before specify deployment template.
-1. In **Deployment template (optional)**, select the key vault template you saved locally. When prompted if you want to overwrite current changes, select **Yes**. The autogenerated form is displayed in the code window. The form is editable from the portal. To customize the form, see [customize form](#customize-form).
-    If you look closely into the autogenerated form, the default title is called **Test Form View**, and there's only one step called **basics** defined.
+1. In **Package Type**, select **CustomTemplate**. Make sure you select the package type before specifying deployment template.
+1. In **Deployment template (optional)**, select the key vault template you saved locally. When prompted if you want to overwrite current changes, select **Yes**. The autogenerated form is displayed in the code window. You can edit the form from the portal. To customize the form, see [customize form](#customize-form).
+    If you look closely at the autogenerated form, the default title is **Test Form View**. There's only one step called **basics** defined.
 
     ```json
     {
@@ -216,43 +216,43 @@ The Azure portal provides a sandbox for creating and previewing forms. This sand
     }
     ```
 
-1. To see that works it without any modifications, select **Preview**.
+1. To see that it works without any modifications, select **Preview**.
 
     :::image type="content" source="./media/template-specs-create-portal-forms/view-portal-basic.png" alt-text="Screenshot of the generated basic Azure portal form.":::
 
-    The sandbox displays the form. It has fields for selecting a subscription, resource group, and region. It also fields for all of the parameters from the template.
+    The sandbox displays the form. It has fields for selecting a subscription, resource group, and region. It also has fields for all of the parameters from the template.
 
-    Most of the fields are text boxes, but some fields are specific for the type of parameter. When your template includes allowed values for a parameter, the autogenerated form uses a drop-down element. The drop-down element is pre-populated with the allowed values.
+    Most of the fields are text boxes, but some fields are specific for the type of parameter. When your template includes allowed values for a parameter, the autogenerated form uses a drop-down element. The drop-down element is prepopulated with the allowed values.
 
-    In between the title and **Project details**, there are no tabs because the default form only has one step defined.  In the **Customize form** section, you'll break the parameters into multiple tabs.
+    Between the title and **Project details**, there are no tabs because the default form only has one step defined. In the **Customize form** section, you break the parameters into multiple tabs.
 
     > [!WARNING]
-    > Don't select **Create** as it will launch a real deployment. You'll have a chance to deploy the template spec later in this tutorial.
+    > Don't select **Create** as it launches a real deployment. You have a chance to deploy the template spec later in this tutorial.
 
 1. To exit from the preview, select **Cancel**.
 
 ## Customize form
 
-The default form is a good starting point for understanding forms but usually you'll want to customize it. You can edit it in the sandbox or in Visual Studio Code. The preview option is only available in the sandbox.
+The default form is a good starting point for understanding forms but usually you want to customize it. You can edit it in the sandbox or in Visual Studio Code. The preview option is only available in the sandbox.
 
 1. Give the form a **title** that describes its use.
 
     ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform.json" range="1-6" highlight="6" :::
 
-1. Your default form had all of the fields for your template combined into one step called **Basics**. To help users to understand the values they're providing, divide the form into steps. Each step contains fields related to a logical part of the solution to deploy.
+1. Your default form had all of the fields for your template combined into one step called **Basics**. To help users understand the values they're providing, divide the form into steps. Each step contains fields related to a logical part of the solution to deploy.
 
-    Find the step labeled **Basics**. You'll keep this step but add steps below it. The new steps will focus on configuring the key vault, setting user permissions, and specifying the secret. Make sure you add a comma after the basics step.
+    Find the step labeled **Basics**. Keep this step but add steps that focus on configuring the key vault, setting user permissions, and specifying the secret. Add a comma after the basics step.
 
     ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/steps.json" highlight="15-32" :::
 
     > [!IMPORTANT]
     > Properties in the form are case-sensitive. Make sure you use the casing shown in the examples.
 
-1. Select **Preview**. You'll see the steps, but most of them don't have any elements.
+1. Select **Preview**. You see the steps, but most of them don't have any elements.
 
     :::image type="content" source="./media/template-specs-create-portal-forms/view-steps.png" alt-text="Screenshot of Azure portal form with multiple steps.":::
 
-1. Now, move elements to the appropriate steps. Start with the elements labeled **Secret Name** and **Secret Value**. Remove these elements from the **Basics** step and add them to the **Secret** step.
+1. Move elements to the appropriate steps. Start with the elements labeled **Secret Name** and **Secret Value**. Remove these elements from the **Basics** step and add them to the **Secret** step.
 
     ```json
     {
@@ -294,7 +294,7 @@ The default form is a good starting point for understanding forms but usually yo
     }
     ```
 
-1. When you move elements, you need to fix the `outputs` section. Currently, the outputs section references those elements as if they were still in the basics step. Fix the syntax so it references the elements in the `secret` step.
+1. When you move elements, fix the `outputs` section. Currently, the outputs section references those elements as if they were still in the basics step. Fix the syntax so it references the elements in the `secret` step.
 
     ```json
     "outputs": {
@@ -305,7 +305,7 @@ The default form is a good starting point for understanding forms but usually yo
       }
     ```
 
-1. Continue moving elements to the appropriate steps. Rather than go through each one, take a look at the updated form.
+1. Continue moving elements to the appropriate steps. Rather than go through each one, look at the updated form.
 
     ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform.json" :::
 
@@ -345,19 +345,19 @@ To test the form, go to the portal and navigate to your template spec. Select **
 
 :::image type="content" source="./media/template-specs-create-portal-forms/deploy-template-spec.png" alt-text="Screenshot of Azure template spec overview with deploy option highlighted.":::
 
-You'll see the form you created. Go through the steps and provide values for the fields.
+You see the form you created. Go through the steps and provide values for the fields.
 
-On the **Basics** step, you'll see a field for **Region**. This field is used for the location of the resource group. On the **Key Vault** step, you'll see a field for **Location**. This field is used for the location of the key vault.
+On the **Basics** step, you see a field for **Region**. This field is for the location of the resource group. On the **Key Vault** step, you see a field for **Location**. This field is for the location of the key vault.
 
-On the **Permissions** step, you can provide your own user ID for the object ID. Use the default value (`["list"]`) for key and secret permissions. You'll improve that option in the next section.
+On the **Permissions** step, provide your user ID for the object ID. Use the default value (`["list"]`) for key and secret permissions. You improve that option in the next section.
 
-When you have finished providing values, select **Create** to deploy the template spec.
+When you finish providing values, select **Create** to deploy the template spec.
 
 ## Improve the form
 
-In the previous section, you added steps and moved elements, but you didn't change any of the default behaviors. In this section, you'll make changes that improve the experience for users of your template spec.
+In the previous section, you added steps and moved elements, but you didn't change any of the default behaviors. In this section, you make changes that improve the experience for users of your template spec.
 
-Previously, the two permissions fields were text boxes. Now, you'll use a drop-down. Set the type to `Microsoft.Common.DropDown`.
+Previously, the two permissions fields were text boxes. Now, you use a drop-down. Set the type to `Microsoft.Common.DropDown`.
 
 Update `keysPermissions`:
 
@@ -367,13 +367,13 @@ And `secretsPermissions`:
 
 ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform2.json" range="253-255" highlight="3" :::
 
-These fields need to pass an array to the template. A regular drop-down won't work because it only lets you select one value. To select more than one value and pass them as an array, add the `multiselect` field and set to `true`.
+These fields need to pass an array to the template. A regular drop-down doesn't work because it only lets you select one value. To select more than one value and pass them as an array, add the `multiselect` field and set it to `true`.
 
 ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform2.json" range="169-173" highlight="5" :::
 
 ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform2.json" range="253-257" highlight="5" :::
 
-Finally, you must specify the allowed values for the drop-down and a default value.
+Finally, specify the allowed values for the drop-down and a default value.
 
 ::: code language="json" source="~/azure-docs-json-samples/azure-resource-manager/ui-forms/keyvaultform2.json" range="169-304" highlight="6-8,12-81,90-92,96-133" :::
 
@@ -407,7 +407,7 @@ Redeploy your template spec with the improved portal form.
 
 :::image type="content" source="./media/template-specs-create-portal-forms/view-portal.png" alt-text="Screenshot of Azure portal form for providing values to a template spec.":::
 
-Notice that your permission fields are now drop-down that allow multiple values.
+Notice that your permission fields are now drop-downs that allow multiple values.
 
 ## Next steps
 

articles/azure-resource-manager/templates/template-tutorial-create-multiple-instances.md

@@ -1,7 +1,7 @@
 ---
 title: Create multiple resource instances
 description: Learn how to create an Azure Resource Manager template (ARM template) to create multiple Azure resource instances.
-ms.date: 06/20/2024
+ms.date: 01/30/2025
 ms.topic: tutorial
 ms.custom: devx-track-arm-template
 ---
@@ -21,13 +21,13 @@ This tutorial covers the following tasks:
 
 If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
 
-For a Learn module that covers resource copy, see [Manage complex cloud deployments by using advanced ARM template features](/training/modules/manage-deployments-advanced-arm-template-features/).
+For a Microsoft Learn module that covers resource copy, see [Manage complex cloud deployments by using advanced ARM template features](/training/modules/manage-deployments-advanced-arm-template-features/).
 
 ## Prerequisites
 
 To complete this article, you need:
 
-* Visual Studio Code with Resource Manager Tools extension. See [Quickstart: Create ARM templates with Visual Studio Code](quickstart-create-templates-use-visual-studio-code.md).
+* Visual Studio Code with Resource Manager Tools extension. For more information, see [Quickstart: Create ARM templates with Visual Studio Code](quickstart-create-templates-use-visual-studio-code.md).
 
 ## Open a Quickstart template
 
@@ -42,7 +42,7 @@ To complete this article, you need:
 
 1. Select **Open** to open the file.
 1. There's a `Microsoft.Storage/storageAccounts` resource defined in the template. Compare the template to the [template reference](/azure/templates/Microsoft.Storage/storageAccounts). It's helpful to get some basic understanding of the template before customizing it.
-1. Select **File** > **Save As** to save the file as _azuredeploy.json_ to your local computer.
+1. To save the file, select **File** > **Save As**. Save the file as _azuredeploy.json_ to your local computer.
 
 ## Edit the template
 
@@ -52,7 +52,7 @@ From Visual Studio Code, make the following four changes:
 
 :::image type="content" source="./media/template-tutorial-create-multiple-instances/resource-manager-template-create-multiple-instances.png" alt-text="Screenshot of Visual Studio Code with Azure Resource Manager creating multiple instances.":::
 
-1. Add a `copy` element to the storage account resource definition. In the `copy` element, you specify the number of iterations and a variable for this loop. The count value must be a positive integer and can't exceed 800.
+1. Add a `copy` element to the storage account resource definition. In the `copy` element, specify the number of iterations and a variable for this loop. The count value must be a positive integer and can't exceed 800.
 
     ```json
     "copy": {
@@ -61,13 +61,12 @@ From Visual Studio Code, make the following four changes:
     },
     ```
 
-1. The `copyIndex()` function returns the current iteration in the loop. You use the index as the name prefix. `copyIndex()` is zero-based. To offset the index value, you can pass a value in the `copyIndex()` function. For example, `copyIndex(1)`.
+1. The `copyIndex()` function returns the current iteration in the loop. Use the index as the name prefix. `copyIndex()` is zero-based. To offset the index value, you can pass a value in the `copyIndex()` function. For example, `copyIndex(1)`.
 
     ```json
     "name": "[format('{0}storage{1}', copyIndex(), uniqueString(resourceGroup().id))]",
     ```
 
-    ```
 
 1. Delete the `storageAccountName` parameter definition, because it's not used anymore.
 1. Delete the `outputs` element. It's no longer needed.
@@ -196,7 +195,7 @@ When the Azure resources are no longer needed, clean up the resources you deploy
 
 1. From the Azure portal, select **Resource group** from the left menu.
 2. Enter the resource group name in the **Filter by name** field.
-3. Select the resource group name.  You shall see a total of three resources in the resource group.
+3. Select the resource group name. You shall see a total of three resources in the resource group.
 4. Select **Delete resource group** from the top menu.
 
 ## Next steps