Addressing PR feedback

Author: yogeshmo

articles/communication-services/quickstarts/email/includes/manage-suppression-list-java.md

@@ -16,7 +16,7 @@ ms.custom: mode-other
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 - An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
 - An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
-- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the AAD application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
+- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the Azure Active Directory (AD) application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
 
 ## Install the required packages
 
@@ -66,7 +66,7 @@ CommunicationManager manager = CommunicationManager
 
 To block your email messages from being sent to certain addresses, the first step is setting up a suppression list in your domain resource.
 
-Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. This information can be found in portal by navigating to the domains resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. The resource group name and subscription ID can be found in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
+Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. Find this information in the portal by navigating to the domain resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. Find the resource group name and subscription ID in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
 
 For the list name, make sure it's the same as the sender username of the MailFrom address you would like to suppress emails from. These MailFrom addresses can be found in the "MailFrom addresses" section of your domain resource in the portal. For example, you may have a MailFrom address that looks like "[email protected]". The sender username for this address would be "donotreply" so a list name of "donotreply" should be used.
 
@@ -95,7 +95,7 @@ manager.suppressionLists().define(suppressionListResourceName)
 
 After setting up the suppression list, you can now add specific email addresses to which you wish to prevent your email messages from being sent.
 
-Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique, so using a GUID is recommended. Update the email address you want to block from receiving your messages as well.
+Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique. We recommend using a GUID. Update the email address you want to block from receiving your messages as well.
 
 To add multiple addresses to the suppression list, you need to repeat this code sample multiple times.
 
@@ -123,9 +123,9 @@ manager.suppressionListAddresses()
 
 You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource or by using one of the Email SDKs](../send-email.md). Make sure to send the email using the MailFrom address with the sender username you choose to suppress. Your email will successfully send to the previously suppressed address.
 
-## Remove a suppression list from a domains resource
+## Remove a suppression list from a domain resource
 
-Call the `delete` method on `suppressionLists` to remove a suppression list from the domains resource.
+Call the `delete` method on `suppressionLists` to remove a suppression list from the domain resource.
 
 ```java
 manager.suppressionLists()

articles/communication-services/quickstarts/email/includes/manage-suppression-list-js.md

@@ -16,7 +16,7 @@ ms.custom: mode-other
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 - An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
 - An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
-- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the AAD application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
+- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the Azure Active Directory (AD) application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
 
 ## Install the required packages
 
@@ -44,7 +44,7 @@ const client = new CommunicationServiceManagementClient(credential, subscription
 
 To block your email messages from being sent to certain addresses, the first step is setting up a suppression list in your domain resource.
 
-Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. This information can be found in portal by navigating to the domains resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. The resource group name and subscription ID can be found in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
+Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. Find this information in the portal by navigating to the domain resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. Find the resource group name and subscription ID in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
 
 For the list name, make sure it's the same as the sender username of the MailFrom address you would like to suppress emails from. These MailFrom addresses can be found in the "MailFrom addresses" section of your domain resource in the portal. For example, you may have a MailFrom address that looks like "[email protected]". The sender username for this address would be "donotreply" so a list name of "donotreply" should be used.
 
@@ -87,7 +87,7 @@ await client.suppressionLists.createOrUpdate(
 
 After setting up the suppression list, you can now add specific email addresses to which you wish to prevent your email messages from being sent.
 
-Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique, so using a GUID is recommended. Update the email address you want to block from receiving your messages as well.
+Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique. We recommend using a GUID. Update the email address you want to block from receiving your messages as well.
 
 To add multiple addresses to the suppression list, you need to repeat this code sample multiple times.
 
@@ -129,9 +129,9 @@ await client.suppressionListAddresses.delete(
 
 You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource or by using one of the Email SDKs](../send-email.md). Make sure to send the email using the MailFrom address with the sender username you choose to suppress. Your email will successfully send to the previously suppressed address.
 
-## Remove a suppression list from a domains resource
+## Remove a suppression list from a domain resource
 
-Call the `delete` method on `suppressionList` to remove a suppression list from the domains resource.
+Call the `delete` method on `suppressionList` to remove a suppression list from the domain resource.
 
 ```javascript
 await client.suppressionLists.delete(

articles/communication-services/quickstarts/email/includes/manage-suppression-list-net.md

@@ -16,7 +16,7 @@ ms.custom: mode-other
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 - An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
 - An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
-- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the AAD application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
+- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the Azure Active Directory (AD) application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
 
 ## Install the required packages
 
@@ -43,7 +43,7 @@ ArmClient client = new ArmClient(new DefaultAzureCredential());
 
 To block your email messages from being sent to certain addresses, the first step is setting up a suppression list in your domain resource.
 
-Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. This information can be found in portal by navigating to the domains resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. The resource group name and subscription ID can be found in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
+Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. Find this information in the portal by navigating to the domain resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. Find the resource group name and subscription ID in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
 
 For the list name, make sure it's the same as the sender username of the MailFrom address you would like to suppress emails from. These MailFrom addresses can be found in the "MailFrom addresses" section of your domain resource in the portal. For example, you may have a MailFrom address that looks like "[email protected]". The sender username for this address would be "donotreply" so a list name of "donotreply" should be used.
 
@@ -82,7 +82,7 @@ suppressionListResource.Update(WaitUntil.Completed, suppressiontListData);
 
 After setting up the suppression list, you can now add specific email addresses to which you wish to prevent your email messages from being sent.
 
-Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique, so using a GUID is recommended. Update the email address you want to block from receiving your messages as well.
+Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique. We recommend using a GUID. Update the email address you want to block from receiving your messages as well.
 
 To add multiple addresses to the suppression list, you need to repeat this code sample multiple times.
 
@@ -114,9 +114,9 @@ suppressionListAddressResource.Delete(WaitUntil.Completed);
 
 You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource or by using one of the Email SDKs](../send-email.md). Make sure to send the email using the MailFrom address with the sender username you choose to suppress. Your email will successfully send to the previously suppressed address.
 
-## Remove a suppression list from a domains resource
+## Remove a suppression list from a domain resource
 
-To remove a suppression list from the domains resource, create the `SuppressionListResource` as shown in the previous code samples and call the `Delete` method.
+To remove a suppression list from the domain resource, create the `SuppressionListResource` as shown in the previous code samples and call the `Delete` method.
 
 ```csharp
 suppressionListResource.Delete(WaitUntil.Completed);

articles/communication-services/quickstarts/email/includes/manage-suppression-list-python.md

@@ -16,7 +16,7 @@ ms.custom: mode-other
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
 - An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
 - An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
-- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the AAD application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
+- We're using a [service principal for authentication](../../../../active-directory/develop/howto-create-service-principal-portal.md). Set the values of the client ID, tenant ID, and client secret of the Azure Active Directory (AD) application as the following environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
 
 ## Install the required packages
 
@@ -44,7 +44,7 @@ mgmt_client = CommunicationServiceManagementClient(credential, subscription_id)
 
 To block your email messages from being sent to certain addresses, the first step is setting up a suppression list in your domain resource.
 
-Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. This information can be found in portal by navigating to the domains resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. The resource group name and subscription ID can be found in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well. 
+Update the code sample with the resource group name, the email service name, and the domain resource name for which you would like to create the suppression list. Find this information in the portal by navigating to the domain resource you created when setting up the prerequisites. The title of the resource is `<your-email-service-name>/<your-domain-name>`. Find the resource group name and subscription ID in the Essentials sections in the domain resource overview. Choose any name for your suppression list resource and update that field in the sample as well.  
 
 For the list name, make sure it's the same as the sender username of the MailFrom address you would like to suppress emails from. These MailFrom addresses can be found in the "MailFrom addresses" section of your domain resource in the portal. For example, you may have a MailFrom address that looks like "[email protected]". The sender username for this address would be "donotreply" so a list name of "donotreply" should be used.
 
@@ -88,7 +88,7 @@ mgmt_client.suppression_lists.create_or_update(
 
 After setting up the suppression list, you can now add specific email addresses to which you wish to prevent your email messages from being sent.
 
-Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique, so using a GUID is recommended. Update the email address you want to block from receiving your messages as well.
+Update the code sample with the suppression list address ID. Every suppression list address ID you add needs to be unique. We recommend using a GUID. Update the email address you want to block from receiving your messages as well.
 
 To add multiple addresses to the suppression list, you need to repeat this code sample multiple times.
 
@@ -129,9 +129,9 @@ mgmt_client.suppression_list_addresses.delete(
 
 You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource or by using one of the Email SDKs](../send-email.md). Make sure to send the email using the MailFrom address with the sender username you've chosen to suppress. Your email will successfully send to the previously suppressed address.
 
-## Remove a suppression list from a domains resource
+## Remove a suppression list from a domain resource
 
-Call the `delete` method on `suppression_lists` to remove a suppression list from the domains resource.
+Call the `delete` method on `suppression_lists` to remove a suppression list from the domain resource.
 
 ```python
 mgmt_client.suppression_lists.delete(

articles/communication-services/quickstarts/email/manage-suppression-list-mgmt-sdks.md renamed to articles/communication-services/quickstarts/email/manage-suppression-list-management-sdks.md

@@ -1,13 +1,13 @@
 ---
-title: Manage Domain Suppression Lists in Azure Communication Services using the Management Client Libraries
+title: Manage domain suppression lists in Azure Communication Services using the management client libraries
 titleSuffix: An Azure Communication Services quick start guide.
-description: Lear about managing Domain Suppression Lists in Azure Communication Services using the Management Client Libraries
+description: Learn about managing domain suppression ists in Azure Communication Services using the management client libraries
 author: yogeshmo
 manager: koagbakp
 services: azure-communication-services
 ms.author: ymohanraj
 ms.date: 11/21/2023
-ms.topic: quickstart
+ms.topic: quickstartl
 ms.service: azure-communication-services
 ms.custom: devx-track-extended-java, devx-track-js, devx-track-python
 zone_pivot_groups: acs-js-csharp-java-python

articles/communication-services/toc.yml

@@ -188,7 +188,7 @@ items:
     - name: Add multiple sender addresses with Azure Communication Services Management SDKs
       href: quickstarts/email/add-multiple-senders-mgmt-sdks.md
     - name: Manage domain suppression lists with Azure Communication Services Management SDKs
-      href: quickstarts/email/manage-suppression-list-mgmt-sdks.md
+      href: quickstarts/email/manage-suppression-list-management-sdks.md
     - name: Sending emails using SMTP 
       items:
         - name: Setting up SMTP Authentication