Merge pull request #107888 from mumian/0305-policy

update the article to make it compliant with the arm quickstart guidance

Author: Jak-MS

articles/governance/policy/assign-policy-template.md

@@ -1,18 +1,19 @@
 ---
 title: "Quickstart: New policy assignment with templates"
 description: In this quickstart, you use a Resource Manager template to create a policy assignment to identify non-compliant resources.
-ms.date: 11/25/2019
+ms.date: 03/16/2020
 ms.topic: quickstart
+ms.custom: subject-armqs
 ---
 # Quickstart: Create a policy assignment to identify non-compliant resources by using a Resource Manager template
 
 The first step in understanding compliance in Azure is to identify the status of your resources.
 This quickstart steps you through the process of creating a policy assignment to identify virtual
-machines that aren't using managed disks.
-
-At the end of this process, you'll successfully identify virtual machines that aren't using managed
+machines that aren't using managed disks. At the end of this process, you'll successfully identify virtual machines that aren't using managed
 disks. They're _non-compliant_ with the policy assignment.
 
+[!INCLUDE [About Azure Resource Manager](../../../includes/resource-manager-quickstart-introduction.md)]
+
 ## Prerequisites
 
 If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account
@@ -24,11 +25,17 @@ In this quickstart, you create a policy assignment and assign a built-in policy
 _Audit VMs that do not use managed disks_. For a partial list of available built-in policies, see
 [Azure Policy samples](./samples/index.md).
 
-There are several methods for creating policy assignments. In this quickstart, you use a
-[quickstart template](https://azure.microsoft.com/resources/templates/101-azurepolicy-assign-builtinpolicy-resourcegroup/).
-Here is a copy of the template:
+### Review the template
+
+The template used in this quickstart is from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/101-azurepolicy-assign-builtinpolicy-resourcegroup/).
+
+:::code language="json" source="~/quickstart-templates/101-azurepolicy-assign-builtinpolicy-resourcegroup/azuredeploy.json" range="1-36" highlight="26-34":::
+
+The resource defined in the template is:
+
+- [Microsoft.Authorization/policyAssignments](/azure/templates/microsoft.authorization/policyassignments)
 
-[!code-json[policy-assignment](~/quickstart-templates/101-azurepolicy-assign-builtinpolicy-resourcegroup/azuredeploy.json)]
+### Deploy the template
 
 > [!NOTE]
 > Azure Policy service is free. For more information, see
@@ -63,7 +70,7 @@ Some additional resources:
 - To learn subscription-level deployment, see
   [Create resource groups and resources at the subscription level](../../azure-resource-manager/templates/deploy-to-subscription.md).
 
-## Identify non-compliant resources
+## Validate the deployment
 
 Select **Compliance** in the left side of the page. Then locate the **Audit VMs that do not use
 managed disks** policy assignment you created.

articles/governance/policy/toc.yml

@@ -11,14 +11,14 @@
   - name: Assign a policy - Portal
     displayName: assign, compliance
     href: assign-policy-portal.md
-  - name: Assign a policy - PowerShell
+  - name: Assign a policy - Azure PowerShell
     displayName: assign, compliance
     href: assign-policy-powershell.md
   - name: Assign a policy - Azure CLI
     displayName: assign, compliance
     href: assign-policy-azurecli.md
-  - name: Assign a policy - template
-    displayName: assign, compliance, resource manager, ARM
+  - name: Assign a policy - ARM template
+    displayName: assign, compliance, resource manager
     href: assign-policy-template.md
 - name: Tutorials
   items: