Merge pull request #265907 from halkazwini/ip-drct

Internet Peering: Freshness: Direct peering walkthrough

Author: JamesJBarnett

articles/internet-peering/walkthrough-direct-all.md

@@ -1,14 +1,14 @@
 ---
 title: Direct peering walkthrough
 titleSuffix: Internet Peering
-description: Get started with Direct peering.
-services: internet-peering
+description: Get started with Direct peering. Learn about the steps that you need to follow to provision and manage a Direct peering.
+ms.author: halkazwini
 author: halkazwini
 ms.service: internet-peering
 ms.topic: how-to
-ms.date: 02/24/2023
-ms.author: halkazwini
-ms.custom: template-how-to, engagement-fy23
+ms.date: 02/09/2024
+
+#CustomerIntent: As an administrator, I want to learn about the requirements to create a Direct peering so I can provision and manage Direct peerings.
 ---
 
 # Direct peering walkthrough
@@ -19,39 +19,40 @@ In this article, you learn how to set up and manage a Direct peering.
 
 :::image type="content" source="./media/walkthrough-direct-all/direct-peering.png" alt-text="Diagram showing Direct peering workflow and connection states." lightbox="./media/walkthrough-direct-all/direct-peering.png":::
 
-The following steps must be followed to provision a Direct peering:
+To provision a Direct peering, complete the following steps:
 
 1. Review Microsoft [peering policy](policy.md) to understand requirements for Direct peering.
 1. Follow the instructions in [Create or modify a Direct peering](howto-direct-powershell.md) to submit a peering request.
 1. After you submit a peering request, Microsoft will contact using your registered email address to provide LOA (Letter Of Authorization) or for other information.
-1. Once peering request is approved, connection state changes to *ProvisioningStarted*.
-1. You need to:
-    1. complete wiring according to the LOA
-    1. (optionally) perform link test using 169.254.0.0/16
+1. Once peering request is approved, connection state changes to ***ProvisioningStarted***. Then, you need to:
+    1. complete wiring according to the LOA.
+    1. (optionally) perform link test using 169.254.0.0/16.
     1. configure BGP session and then notify Microsoft.
 1. Microsoft provisions BGP session with DENY ALL policy and validate end-to-end.
-1. If successful, you receive a notification that peering connection state is *Active*.
-1. Traffic will then be allowed through the new peering.
+1. If successful, you receive a notification that peering connection state is ***Active***.
+1. Traffic is then allowed through the new peering.
 
 > [!NOTE]
 > Connection states are different from standard BGP session states.
 
-## Convert a legacy Direct peering to Azure resource
+## Convert a legacy Direct peering to an Azure resource
+
+To convert a legacy Direct peering to an Azure resource, complete the following steps:
 
-The following steps must be followed to convert a legacy Direct peering to Azure resource:
 1. Follow the instructions in [Convert a legacy Direct peering to Azure resource](howto-legacy-direct-portal.md)
-1. After you submit the conversion request, Microsoft will review the request and contact you if necessary.
-1. Once approved, you see your Direct peering with a connection state as *Active*.
+1. After you submit the conversion request, Microsoft reviews the request and contacts you if necessary.
+1. Once approved, you see your Direct peering with a connection state as ***Active***.
 
 ## Deprovision Direct peering
 
 Contact [Microsoft peering](mailto:[email protected]) team to deprovision a Direct peering.
 
-When a Direct peering is set for deprovision, you see the connection state as *PendingRemove*.
+When a Direct peering is set for deprovision, the connection state changes to ***PendingRemove***.
 
 > [!NOTE]
-> If you run PowerShell cmdlet to delete the Direct peering when the ConnectionState is *ProvisioningStarted* or *ProvisioningCompleted*, the operation will fail.
+> If you run PowerShell cmdlet to delete the Direct peering when the ConnectionState is ***ProvisioningStarted*** or ***ProvisioningCompleted***, the operation will fail.
 
-## Next steps
+## Related content
 
-* Learn about the [Prerequisites to set up peering with Microsoft](prerequisites.md).
+- Learn about the [Prerequisites to set up peering with Microsoft](prerequisites.md).
+- Learn about the [Peering policy](policy.md).