acrolinx

Author: neilpeterson

articles/azure-resource-manager/templates/quickstart-create-templates-use-visual-studio-code.md

@@ -12,15 +12,15 @@ ms.author: nepeters
 
 # Quickstart: Create Azure Resource Manager templates by using Visual Studio Code
 
-The Azure Resource Manager (ARM) Tools for Visual Studio Code provides language support, resource snippets, and resource auto-completion to help you create and validate Azure Resource Manager templates. In this quickstart, you use the ARM tools to create an Azure Resource Manager template from scratch. While doing so you experience ARM tools capabilities such as ARM template snippets, validation, completions, and parameter file support.
+The Azure Resource Manager (ARM) Tools for Visual Studio Code provide language support, resource snippets, and resource autocompletion to help you create and validate Azure Resource Manager templates. In this quickstart, you use the ARM tools to create an Azure Resource Manager template from scratch. While doing so you experience ARM tools capabilities such as ARM template snippets, validation, completions, and parameter file support.
 
-In order to complete this quickstart, you need [Visual Studio Code](https://code.visualstudio.com/), with the [Azure Resource Manager (ARM) tools extension](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools) installed. You also need either the [Azure CLI]() or the Azure PowerShell module installed and authenticated.
+To complete this quickstart, you need [Visual Studio Code](https://code.visualstudio.com/), with the [Azure Resource Manager (ARM) tools extension](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools) installed. You also need either the [Azure CLI]() or the Azure PowerShell module installed and authenticated.
 
 If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
 
 ## Create an ARM template
 
-Create and open with Visual Studio Code a new file named *azuredeploy.json*. Enter `arm` into the code editor which initiates ARM Tools snippets for scaffolding out an ARM template.
+Create and open with Visual Studio Code a new file named *azuredeploy.json*. Enter `arm` into the code editor, which initiates ARM Tools snippets for scaffolding out an ARM template.
 
 Select `arm!` to create a template scoped for an Azure resource group deployment.
 
@@ -30,7 +30,7 @@ This snippet creates the basic building blocks for an ARM template.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/2.png)
 
-Notice that the VS Code language mode has changed from *JSON* to *Azure Resource Manager Template*. The ARM Tools extension includes a language server specific to ARM templates which provides ARM template specific validation, completion, and other language services.
+Notice that the VS Code language mode has changed from *JSON* to *Azure Resource Manager Template*. The ARM Tools extension includes a language server specific to ARM templates which provides ARM template-specific validation, completion, and other language services.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/3.png)
 
@@ -42,7 +42,7 @@ Place the cursor in the template **resources** block, type in `storage`, and sel
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/4.png)
 
-This adds a storage resource to the template.
+This action adds a storage resource to the template.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/5.png)
 
@@ -54,7 +54,7 @@ The **tab** key can be used to tab through configurable properties on the storag
 
 One of the most powerful capabilities of the ARM Tools extension for VS Code is its integration with Azure schemas. Azure schemas provide the extension with validation and resource-aware completion capabilities. Let's modify the storage account to see validation and completion in action. 
 
-First, update the storage account kind to an invalid value such as `megaStorage`. Notice that this produces a warning indicating that `megaStorage` is not a valid value.
+First, update the storage account kind to an invalid value such as `megaStorage`. Notice that this action produces a warning indicating that `megaStorage` is not a valid value.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/7.png)
 
@@ -66,7 +66,7 @@ To use the completion capabilities, remove `megaStorage`, place the cursor insid
 
 Now create and use a parameter to specify the storage account name.
 
-Place your cursor in the parameters block, add a carriage return, type `par`, and then select the `arm-param-value` snippet. This adds a generic parameter to the template.
+Place your cursor in the parameters block, add a carriage return, type `par`, and then select the `arm-param-value` snippet. This action adds a generic parameter to the template.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/9.png)
 
@@ -88,7 +88,7 @@ Entering a single quote `'` inside of the round brackets produces a list of all
 
 ## Create a parameter file
 
-An ARM template parameter file allows you to store environment-specific parameter values and pass these in as a group at deployment time. For example, you may have a parameter file with values specific to a test environment and another for a production environment.
+An ARM template parameter file allows you to store environment-specific parameter values and pass these values in as a group at deployment time. For example, you may have a parameter file with values specific to a test environment and another for a production environment.
 
 The ARM Tools extension for VS Code makes it easy to create a parameter file from your existing templates. To do so, right-click on the template in the code editor and select `Select/Create Parameter File`.
 
@@ -98,11 +98,11 @@ Select `New` > `All Parameters` > Select a name and location for the parameter f
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/15.png)
 
-This will create a new parameters file and map it with the template from which it was created. You can see and modify the current template/parameter file mapping in the VS Code status bar while the template is selected.
+This action creates a new parameters file and map it with the template from which it was created. You can see and modify the current template/parameter file mapping in the VS Code status bar while the template is selected.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/16.png)
 
-Now that the parameter file has been mapped to the template, the ARM Tools extension validates both the template and parameter file together. To see this in practice, add a two-character value to the `storageAccountName` parameter in the parameter file and save the file.
+Now that the parameter file has been mapped to the template, the ARM Tools extension validates both the template and parameter file together. To see this validation in practice, add a two-character value to the `storageAccountName` parameter in the parameter file and save the file.
 
 ![](./media/quickstart-create-templates-use-visual-studio-code/17.png)
 
@@ -112,7 +112,7 @@ Navigate back to the ARM template and notice that an error has been raised indic
 
 Update the value to something appropriate, save the file, and navigate back to the template. Notice that the error on the parameter has been resolved.
 
-## Template deployment
+## Deploy the template
 
 Open the integrated VS Code terminal using the `ctrl` + ```` ` ```` key combination and use either the Azure CLI or Azure PowerShell module to deploy the template.