Addressing PR comments

Author: pgrandhi

articles/communication-services/quickstarts/events/includes/create-eventsubscription-az-cli.md renamed to articles/communication-services/quickstarts/events/includes/create-event-subscription-az-cli.md

@@ -17,7 +17,7 @@ ms.author: pgrandhi
 
 [!INCLUDE [register-provider-cli.md](register-provider-cli.md)]
 
-## Create Event Subscription
+## Create event subscription
 
 To create event subscriptions for Azure Communication Services resource, [sign in to Azure CLI](/cli/azure/authenticate-azure-cli). You can sign in running the ```az login``` command from the terminal and providing your credentials. Run the following command to create the event subscription for the resource:
 
@@ -34,7 +34,7 @@ az eventgrid event-subscription create
 
 For a list of Communication Services events, see [Communication Services Events](../../../../../articles/event-grid/event-schema-communication-services.md).
 
-## List Event Subscriptions
+## List event subscriptions
 
 To list all the existing event subscriptions set up for an Azure Communication Services resource, by using [the Azure CLI](/cli/azure/get-started-with-azure-cli), use the [`az eventgrid event-subscription list`](/cli/azure/eventgrid/event-subscription#az-eventgrid-event-subscription-list) command. 
 
@@ -47,7 +47,7 @@ az eventgrid event-subscription update
     --endpoint https://azureeventgridviewer.azurewebsites.net/api/updates
 ```
 
-## Update Event Subscription
+## Update event subscription
 
 To update an existing event subscription by using [the Azure CLI](/cli/azure/get-started-with-azure-cli), use the [`az eventgrid event-subscription update`](/cli/azure/eventgrid/event-subscription#az-eventgrid-event-subscription-update) command. 
 
@@ -56,7 +56,7 @@ az eventgrid event-subscription list
     --source-resource-id /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>    
 ```
 
-## Delete Event Subscription
+## Delete event subscription
 
 To delete an existing event subscription by using [the Azure CLI](/cli/azure/get-started-with-azure-cli), use the [`az eventgrid event-subscription delete`](/cli/azure/eventgrid/event-subscription#az-eventgrid-event-subscription-delete) command. 
 

articles/communication-services/quickstarts/events/includes/create-eventsubscription-azp.md renamed to articles/communication-services/quickstarts/events/includes/create-event-subscription-azp.md

@@ -14,7 +14,7 @@ ms.author: pgrandhi
 
 [!INCLUDE [register-event-grid-resource-provider.md](register-event-grid-resource-provider.md)]
 
-## Create Event Subscription
+## Create event subscription
 
 To create an Event subscription for Azure Communication Services, use the following steps. This article shows how to create an Event subscription for Azure Communication Services to receive events via Webhook.
 
@@ -43,7 +43,7 @@ For more information on Communication Services events, see [Communication Servic
 
 1. Enter the link to the webhook and Select **Confirm Selection**.
 
-    :::image type="content" source="../media/subscribe-through-portal/select-webhook-endpoint.png" alt-text="Screenshot highlighting the select webhook endpoint page in the Azure portal." lightbox="../media/subscribe-through-portal/select-webhook-endpoint.png":::
+    :::image type="content" source="../media/subscribe-through-portal/select-web-hook-endpoint.png" alt-text="Screenshot highlighting the select webhook endpoint page in the Azure portal." lightbox="../media/subscribe-through-portal/select-webhook-endpoint.png":::
 
 1. In the **Filters** tab, add the names of the event types you want to filter in the subscription and add context attribute filters you want to use in the subscription. Then, select **Next: Additional features** at the bottom of the page.
 
@@ -56,7 +56,7 @@ For more information on Communication Services events, see [Communication Servic
 1. When done, select **Create**.
 
 
-## Update Event Subscription
+## Update event subscription
 
 To update an Event subscription for Azure Communication Services, use the following steps. This section shows how to update an Event subscription for Azure Communication Services to update the events you want to receive via Webhook.
 
@@ -76,12 +76,12 @@ To update an Event subscription for Azure Communication Services resource, first
     :::image type="content" source="../media/subscribe-through-portal/select-additional-features.png" alt-text="Screenshot that shows the Additional features tab of the Update Event Subscription page." lightbox="../media/subscribe-through-portal/select-additional-features.png":::
 
 1. To update the webhook to receive events, select on **Change** next to the webhook link and enter the new webhook endpoint. 
-     :::image type="content" source="../media/subscribe-through-portal/update-webhook-endpoint.png" alt-text="Screenshot that shows the Change the webhook endpoint link in the Event Subscription page." lightbox="../media/subscribe-through-portal/update-webhook-endpoint.png":::
+     :::image type="content" source="../media/subscribe-through-portal/update-web-hook-endpoint.png" alt-text="Screenshot that shows the Change the webhook endpoint link in the Event Subscription page." lightbox="../media/subscribe-through-portal/update-webhook-endpoint.png":::
 
 1. When done, select **Save**,
      :::image type="content" source="../media/subscribe-through-portal/save-update.png" alt-text="Screenshot that shows the save button in the Azure portal." lightbox="../media/subscribe-through-portal/update-webhook-endpoint.png":::
 
-## Delete Event Subscription
+## Delete event subscription
 
 To delete an Event subscription for Azure Communication Services, use the following steps.
 

articles/communication-services/quickstarts/events/includes/create-eventsubscription-net.md renamed to articles/communication-services/quickstarts/events/includes/create-event-subscription-net.md

@@ -10,8 +10,8 @@ ms.author: pgrandhi
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 - The latest version [.NET Core SDK](https://dotnet.microsoft.com/download/dotnet-core) for your operating system.
-- Get the latest version of the [.NET Microsoft Azure EventGrid Management SDK](/azure/event-grid/sdk-overview).
-- Setup a way to authenticate to Azure with [Azure Identity](/dotnet/api/overview/azure/identity-readme) library as described below.
+- Get the latest version of the [.NET Microsoft Azure Event Grid Management SDK](/azure/event-grid/sdk-overview).
+- Get the latest version of the [Azure Identity](/dotnet/api/overview/azure/identity-readme) library.
 - An [Azure Communication Services resource](../../create-communication-resource.md).
 
 [!INCLUDE [register-event-grid-resource-provider.md](register-event-grid-resource-provider.md)]
@@ -23,7 +23,7 @@ First, install the Microsoft Azure Event Grid Management library for .NET with [
 ```csharp
 dotnet add package Azure.ResourceManager.EventGrid;
 ```
-1. Include the Communication Services Management SDK in your C# project:
+Include the Event Grid Management SDK in your C# project:
 
 ```csharp
 using Microsoft.Azure.Management.EventGrid;
@@ -33,12 +33,12 @@ using Microsoft.Azure.Management.EventGrid.Models;
 ## Authenticating with Azure Identity library
 
 ### Prerequisites:
-1. Create a Microsoft Entra application and Service Principal that can access the resources in your subscription by following the instructions [here](/entra/identity-platform/howto-create-service-principal-portal).
-2. Create a new Client secret or upload a trusted certificate issued by a certificate authority following the instructions above. This secret or certificate should be stored in the Keyvault.
-3. Give contributor or owner access to the subscription to that application following the instructions [here](/azure/role-based-access-control/quickstart-assign-role-user-portal).
-4. Read more about authorizing access to Event Grid resources [here](/azure/event-grid/security-authorization). 
+1. Create a Microsoft Entra application and Service Principal and set up a client secret or trusted certificate issued by certificate authority by following the instructions [here](/entra/identity-platform/howto-create-service-principal-portal).
+1. Store the secret or the certificate in the Azure Keyvault. 
+1. Give contributor or owner access to the subscription to that application following the instructions [here](/azure/role-based-access-control/quickstart-assign-role-user-portal).
+1. Read more about authorizing access to Event Grid resources [here](/azure/event-grid/security-authorization). 
 
-The Azure Identity library provides Microsoft Entra ID (Formerly Azure Active Directory) token authentication support across the Azure SDK. It provides a set of TokenCredential implementations which can be used to construct Azure SDK clients which support Microsoft Entra token authentication. You can read more about it [here](/dotnet/api/overview/azure/identity-readme).
+The Azure Identity library provides Microsoft Entra ID (Formerly Azure Active Directory) token authentication support across the Azure SDK. It provides a set of TokenCredential implementations, which can be used to construct Azure SDK clients that support Microsoft Entra token authentication. You can read more about it [here](/dotnet/api/overview/azure/identity-readme).
 
 1. Include the Azure Identity client library for .NET with [NuGet](https://www.nuget.org/):
 
@@ -55,58 +55,57 @@ using Azure.Security.KeyVault.Secrets
 
 3. You can either pass the secret credentials or certificate credentials to get access token, based on how your Service Principal is configured.
 
-a. Get Access token using secret credential
-
-To get the secret credentials, you will need to read it from the Keyvault you created in Prerequisite #2 using [SecretClient](/azure/key-vault/secrets/quick-create-net). 
-
-```csharp
-// Authenticate the Keyvault client with DefaultAzureCredential and get the secret.
-SecretClient secretClient = new SecretClient(new Uri("https://myvault.vault.azure.net/"), new DefaultAzureCredential());
-string clientSecret = await secretClient.GetSecretAsync(secretName).Value;
-
-// Get access token using secret credentials
-string[] scopes = { "https://management.azure.com/.default" };
-var application = ConfidentialClientApplicationBuilder
-                    .Create('your-servicePrincipal-appId')
-                    .WithAuthority(authorityUri: new Uri(authority), validateAuthority: true)
-                    .WithTenantId('your-tenant_id')
-                    .WithClientSecret(clientSecret)
-                    .Build();
-
-var token = await application
-                .AcquireTokenForClient(scopes)
-                .ExecuteAsync();
-```
-
-
-b. Get Access token using certificate credential
-
-To get the secret credentials, you will need to read it from the Keyvault you created in Prerequisite #2 using [CertificateClient](/azure/key-vault/certificates/quick-create-net). 
-
-Read more about the Microsoft Entra Application configuration Authority [here](/entra/identity-platform/msal-client-application-configuration)
-
-```csharp
-// Authenticate the certificate client with DefaultAzureCredential and get the certificate.
-CertificateClient certificateClient = new SecretClient(new Uri("https://myvault.vault.azure.net/"), new DefaultAzureCredential());
-X509Certificat2 cert = await certificateClient.DownloadCertificateAsync(certificateName);
-
-// Get access token using certificate credentials
-string[] scopes = { "https://management.azure.com/.default" };
-string authority = "https://login.microsoftonline.com/<tenant>/";
-var application = ConfidentialClientApplicationBuilder
-                    .Create('<servicePrincipal-appId>')
-                    .WithAuthority(authorityUri: new Uri(authority), validateAuthority: true)
-                    .WithTenantId("<tenantId>")
-                    .WithCertificate(cert)
-                    .Build();
-
-var token = await application
-                .AcquireTokenForClient(scopes)
-                .WithSendX5C(true)
-                .ExecuteAsync();
-```
-
-4. Authenticate EventGridManagementClient with Acess Token using SecretCredential or CertificateCredential
+    * Get access token using secret credential
+
+        To get the secret credentials, you need to read it from the Keyvault you created in Prerequisite #2 using [SecretClient](/azure/key-vault/secrets/quick-create-net). 
+        
+        ```csharp
+        // Authenticate the Keyvault client with DefaultAzureCredential and get the secret.
+        SecretClient secretClient = new SecretClient(new Uri("https://myvault.vault.azure.net/"), new DefaultAzureCredential());
+        string clientSecret = await secretClient.GetSecretAsync(secretName).Value;
+        
+        // Get access token using secret credentials
+        string[] scopes = { "https://management.azure.com/.default" };
+        var application = ConfidentialClientApplicationBuilder
+                            .Create('your-servicePrincipal-appId')
+                            .WithAuthority(authorityUri: new Uri(authority), validateAuthority: true)
+                            .WithTenantId('your-tenant_id')
+                            .WithClientSecret(clientSecret)
+                            .Build();
+        
+        var token = await application
+                        .AcquireTokenForClient(scopes)
+                        .ExecuteAsync();
+        ```
+
+    * Get access token using certificate credential
+
+        To get the certificate credentials, you need to read it from the Keyvault you created in Prerequisite #2 using [CertificateClient](/azure/key-vault/certificates/quick-create-net). 
+        
+        Read more about the Microsoft Entra application configuration authority [here](/entra/identity-platform/msal-client-application-configuration)
+        
+        ```csharp
+        // Authenticate the certificate client with DefaultAzureCredential and get the certificate.
+        CertificateClient certificateClient = new SecretClient(new Uri("https://myvault.vault.azure.net/"), new DefaultAzureCredential());
+        X509Certificat2 cert = await certificateClient.DownloadCertificateAsync(certificateName);
+        
+        // Get access token using certificate credentials
+        string[] scopes = { "https://management.azure.com/.default" };
+        string authority = "https://login.microsoftonline.com/<tenant>/";
+        var application = ConfidentialClientApplicationBuilder
+                            .Create('<servicePrincipal-appId>')
+                            .WithAuthority(authorityUri: new Uri(authority), validateAuthority: true)
+                            .WithTenantId("<tenantId>")
+                            .WithCertificate(cert)
+                            .Build();
+        
+        var token = await application
+                        .AcquireTokenForClient(scopes)
+                        .WithSendX5C(true)
+                        .ExecuteAsync();
+        ```
+
+4. Authenticate EventGridManagementClient with access token using secret or certificate credentials
 
 
 ```csharp
@@ -140,8 +139,8 @@ await eventGridClient.EventSubscriptions.CreateOrUpdateAsync(
     eventSubscriptionInfo: eventSubscription);
 ```
 
-## Update Event Subscription
-This code sample shows how to update the event subscription to add additional events you want to receive on the webhook subscriber endpoint.
+## Update event subscription
+This code sample shows how to update the event subscription to add more events, you want to receive on the webhook subscriber endpoint.
 
 ```csharp
 string webhookUri = $"<webhookUri>";
@@ -157,8 +156,8 @@ await eventGridClient.EventSubscriptions.UpdateAsync(
             filter: new EventSubscriptionFilter(includedEventTypes: additionalEventTypes)));
 ```
 
-## Delete Event Subscription
-This code sample shows how to delete the event susbcription for the webhook subscriber endpoint.
+## Delete event Subscription
+This code sample shows how to delete the event subscription for the webhook subscriber endpoint.
 
 ```csharp
 string webhookUri = $"<webhookUri>";

articles/communication-services/quickstarts/events/includes/create-eventsubscription-powershell.md renamed to articles/communication-services/quickstarts/events/includes/create-event-subscription-powershell.md

@@ -17,7 +17,7 @@ ms.author: pgrandhi
 
 [!INCLUDE [register-provider-powershell.md](register-provider-powershell.md)]
 
-## Create Event Subscription
+## Create event subscription
 
 First, make sure to install the Azure Communication Services module ```Az.EventGrid``` using the following command.
 
@@ -51,7 +51,7 @@ New-AzEventGridSubscription
 
 For a list of Communication Services events, see [Communication Services Events](../../../../../articles/event-grid/event-schema-communication-services.md).
 
-## List Event Subscriptions
+## List event subscriptions
 
 To list all the existing event subscriptions set up for an Azure Communication Services resource, by using the [Azure PowerShell](/powershell/azure/get-started-azureps), use the [`Get-AzEventGridSubscription`](/powershell/module/az.eventgrid/get-azeventgridsubscription) command. 
 
@@ -60,7 +60,7 @@ Get-AzEventGridSubscription
     -ResourceId "/subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Communication/CommunicationServices/<acsResourceName>"
 ```
 
-## Update Event Subscription
+## Update event subscription
 
 To update an existing event subscription by using the [Azure PowerShell](/powershell/azure/get-started-azureps), use the [`Update-AzEventGridSubscription `](/powershell/module/az.eventgrid/update-azeventgridsubscription) command. 
 
@@ -75,7 +75,7 @@ Update-AzEventGridSubscription
  
 ```
 
-## Delete Event Subscription
+## Delete event subscription
 
 To delete an existing event subscription by using the [Azure PowerShell](/powershell/azure/get-started-azureps), use the [`Remove-AzEventGridSubscription`](/powershell/module/az.eventgrid/remove-azeventgridsubscription) command. 
 
@@ -86,4 +86,4 @@ Get-AzResource
 
 ## Next steps
 
-* For information on other commands, see [Az.EventGrid Powershell Module](/powershell/module/az.eventgrid/new-azeventgridsubscription).
+* For information on other commands, see [Az.EventGrid PowerShell Module](/powershell/module/az.eventgrid/new-azeventgridsubscription).

articles/communication-services/quickstarts/events/includes/register-event-grid-resource-provider.md

@@ -6,7 +6,7 @@ ms.date: 01/26/2024
 ms.author: pgrandhi
 ---
 
-## Register the Event Grid Resource Provider
+## Register the event grid resource provider
 
 This article describes how to register Event Grid Resource Provider. If you have used Event Grid before in the same subscription, skip to the next section.
 

articles/communication-services/quickstarts/events/includes/register-provider-cli.md

@@ -7,7 +7,7 @@ ms.date: 01/27/2024
 ms.author: pgrandhi
 ---
 
-## Register Event Grid resource provider
+## Register the event grid resource provider
 
 1. If you haven't previously used Event Grid in your Azure subscription, you might need to register the Event Grid resource provider. Run the following command to register the provider:
 

articles/communication-services/quickstarts/events/includes/register-provider-powershell.md

@@ -7,9 +7,9 @@ ms.date: 01/27/2024
 ms.author: pgrandhi
 ---
 
-## Register Event Grid resource provider
+## Register the event grid resource provider
 
-If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider. Run the following command:
+If you have not previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider. Run the following command:
 
 ```PowerShell
 Register-AzResourceProvider -ProviderNamespace Microsoft.EventGrid