Merge pull request #113817 from DCtheGeek/dmc-ph-network

Azure Policy samples - Virtual Network

Author: megvanhuygen

articles/virtual-network/policy-samples.md

@@ -1,28 +1,24 @@
 ---
-title: Policy template samples | Microsoft Docs
-description: Azure Policy template samples for Virtual Network.
-services: virtual-network
-documentationcenter:
-author: KumudD
-manager: twooley
-editor:
-tags:
-ms.assetid:
-ms.service: virtual-network
-ms.devlang: na
-ms.topic: sample
-ms.tgt_pltfrm:
-ms.workload:
+title: Built-in policy definitions for Azure Virtual Network
+description: Lists Azure Policy built-in policy definitions for Azure Virtual Network. These built-in policy definitions provide common approaches to managing your Azure resources.
 ms.date: 05/05/2020
+ms.topic: sample
+author: KumudD
 ms.author: kumud
-ms.custom: mvc
-
+ms.service: virtual-network
+ms.custom: subject-policy-samples
 ---
-# Azure Policy sample built-ins for virtual network
+# Azure Policy built-in policy definitions for Azure Virtual Network
+
+This page is an index of [Azure Policy](../governance/policy/overview.md) built-in policy
+definitions for Azure Virtual Network. For additional Azure Policy built-ins for other services,
+see [Azure Policy built-in definitions](../governance/policy/samples/built-in-policies.md).
 
-The following table includes links to [Azure Policy](../governance/policy/overview.md) samples. The samples are found in the [Azure Policy samples repository](https://github.com/Azure/azure-policy).
+The name of each built-in policy definition links to the policy definition in the Azure portal. Use
+the link in the **GitHub** column to view the source on the
+[Azure Policy GitHub repo](https://github.com/Azure/azure-policy).
 
-## Network
+## Azure Virtual Network
 
 [!INCLUDE [azure-policy-samples-policies-network](../../includes/policy/samples/bycat/policies-network.md)]
 
@@ -33,3 +29,9 @@ The following table includes links to [Azure Policy](../governance/policy/overvi
 ## General
 
 [!INCLUDE [azure-policy-samples-policies-general](../../includes/policy/samples/bycat/policies-general.md)]
+
+## Next steps
+
+- See the built-ins on the [Azure Policy GitHub repo](https://github.com/Azure/azure-policy).
+- Review the [Azure Policy definition structure](../governance/policy/concepts/definition-structure.md).
+- Review [Understanding policy effects](../governance/policy/concepts/effects.md).

articles/virtual-network/toc.yml

@@ -35,8 +35,9 @@
     href: powershell-samples.md
   - name: Resource Manager templates
     href: template-samples.md
-  - name: Azure Policy templates
-    href: policy-samples.md
+  - name: Azure Policy built-ins
+    displayName: samples, policies, definitions
+    href: ./policy-samples.md
 - name: Concepts
   items:
   - name: Business continuity