Addressing PR feedback

Author: Yogesh Mohanraj (from Dev Box)

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

@@ -71,14 +71,23 @@ Update the code sample with the resource group name, the email service name, and
 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.
 
 ```java
-String resourceGroupName = "<your-resource-group-name>";
-String emailServiceName = "<your-email-service-name>";
-String domainResourceName = "<your-domain-name>";
+String resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
+String emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
+String domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
 String suppressionListResourceName = "<your-suppression-list-resource-name>";
 
 manager.suppressionLists().define(suppressionListResourceName)
     .withExistingDomain(resourceGroupName, emailServiceName, domainResourceName)
-    .withListName("<your-sender-username>")
+    .withListName("<your-sender-username>") // Should match the sender username of the MailFrom address you would like to suppress emails from
+    .create();
+```
+
+If you would like to suppress emails from all the sender usernames in particular domain, you can pass in an empty string for the list name.
+
+```java
+manager.suppressionLists().define(suppressionListResourceName)
+    .withExistingDomain(resourceGroupName, emailServiceName, domainResourceName)
+    .withListName("")
     .create();
 ```
 
@@ -95,11 +104,13 @@ String suppressionListAddressId = "<your-suppression-list-address-id>";
 
 manager.suppressionListAddresses().define(suppressionListAddressId)
     .withExistingSuppressionList(resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName)
-    .withEmail("<email-address-to-suppress>")
+    .withEmail("<email-address-to-suppress>") // Should match the email address you would like to block from receiving your messages
     .create();
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email won't be sent to the suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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 won't be sent to the suppressed address.
+
+If you try sending an email with a domain that has not been suppressed, you will see that the email successfully sends.
 
 ## Remove an address from a suppression list
 
@@ -110,7 +121,7 @@ manager.suppressionListAddresses()
     .delete(resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName, suppressionListAddressId);
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email will successfully send to the previously suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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
 

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

@@ -49,13 +49,29 @@ Update the code sample with the resource group name, the email service name, and
 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.
 
 ```javascript
-const resourceGroupName = "<your-resource-group-name>";
-const emailServiceName = "<your-email-service-name>";
-const domainResourceName = "<your-domain-name>";
+const resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
+const emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
+const domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
 const suppressionListResourceName = "<your-suppression-list-resource-name>";
 
 parameters = { 
-    "listName": "<your-sender-username>",
+    "listName": "<your-sender-username>", // Should match the sender username of the MailFrom address you would like to suppress emails from
+}
+
+await client.suppressionLists.createOrUpdate(
+    resourceGroupName,
+    emailServiceName,
+    domainResourceName,
+    suppressionListResourceName,
+    parameters
+);
+```
+
+If you would like to suppress emails from all the sender usernames in particular domain, you can pass in an empty string for the list name.
+
+```javascript
+parameters = { 
+    "listName": "",
 }
 
 await client.suppressionLists.createOrUpdate(
@@ -79,7 +95,7 @@ To add multiple addresses to the suppression list, you need to repeat this code
 const suppressionListAddressId = "<your-suppression-list-address-id>";
 
 parameters = { 
-    "email": "<email-address-to-suppress>"
+    "email": "<email-address-to-suppress>" // Should match the email address you would like to block from receiving your messages
 }
 
 await client.suppressionListAddresses.createOrUpdate(
@@ -93,7 +109,9 @@ await client.suppressionListAddresses.createOrUpdate(
 
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email won't be sent to the suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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 won't be sent to the suppressed address.
+
+If you try sending an email with a domain that has not been suppressed, you will see that the email successfully sends.
 
 ## Remove an address from a suppression list
 
@@ -109,7 +127,7 @@ await client.suppressionListAddresses.delete(
 );
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email will successfully send to the previously suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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
 

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

@@ -50,18 +50,29 @@ For the list name, make sure it's the same as the sender username of the MailFro
 The code sample will create the suppression list and store it in the `suppressionListResource` variable for future operations.
 
 ```csharp
-string subscriptionId = "<your-subscription-id>";
-string resourceGroupName = "<your-resource-group-name>";
-string emailServiceName = "<your-email-service-name>";
-string domainResourceName = "<your-domain-name>";
+string subscriptionId = "<your-subscription-id>"; // Found in the essentials section of the domain resource portal overview
+string resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
+string emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
+string domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
 string suppressionListResourceName = "<your-suppression-list-resource-name>";
 
 ResourceIdentifier suppressionListResourceId = SuppressionListResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName);
 SuppressionListResource suppressionListResource = client.GetSuppressionListResource(suppressionListResourceId);
 
 SuppressionListResourceData suppressiontListData = new SuppressionListResourceData()
 {
-    ListName = "<your-sender-username>",
+    ListName = "<your-sender-username>", // Should match the sender username of the MailFrom address you would like to suppress emails from
+};
+
+suppressionListResource.Update(WaitUntil.Completed, suppressiontListData);
+```
+
+If you would like to suppress emails from all the sender usernames in particular domain, you can pass in an empty string for the list name.
+
+```csharp
+SuppressionListResourceData suppressiontListData = new SuppressionListResourceData()
+{
+    ListName = "",
 };
 
 suppressionListResource.Update(WaitUntil.Completed, suppressiontListData);
@@ -83,13 +94,15 @@ SuppressionListAddressResource suppressionListAddressResource = client.GetSuppre
 
 SuppressionListAddressResourceData suppressionListAddressData = new SuppressionListAddressResourceData()
 {
-    Email = "<email-address-to-suppress>"
+    Email = "<email-address-to-suppress>" // Should match the email address you would like to block from receiving your messages
 };
 
 suppressionListAddressResource.Update(WaitUntil.Completed, suppressionListAddressData);
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email won't be sent to the suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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 won't be sent to the suppressed address.
+
+If you try sending an email with a domain that has not been suppressed, you will see that the email successfully sends.
 
 ## Remove an address from a suppression list
 
@@ -99,7 +112,7 @@ To remove an address from the suppression list, create the `SuppressionListAddre
 suppressionListAddressResource.Delete(WaitUntil.Completed);
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email will successfully send to the previously suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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
 

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

@@ -50,9 +50,9 @@ For the list name, make sure it's the same as the sender username of the MailFro
 
 
 ```python
-resource_group_name = "<your-resource-group-name>";
-email_service_name = "<your-email-service-name>";
-domain_resource_name = "<your-domain-name>";
+resource_group_name = "<your-resource-group-name>"; # Found in the essentials section of the domain resource portal overview
+email_service_name = "<your-email-service-name>"; # Found in the first part of the portal domain resource title
+domain_resource_name = "<your-domain-name>"; # Found in the second part of the portal domain resource title
 suppression_list_resource_name = "<your-suppression-list-resource-name>";
 
 mgmt_client.suppression_lists.create_or_update(
@@ -62,7 +62,23 @@ mgmt_client.suppression_lists.create_or_update(
     suppression_list_resource_name,
     parameters={
         "properties": {
-            "listName": "<your-sender-username>"
+            "listName": "<your-sender-username>" # Should match the sender username of the MailFrom address you would like to suppress emails from
+        }
+    },
+)
+```
+
+If you would like to suppress emails from all the sender usernames in particular domain, you can pass in an empty string for the list name.
+
+```python
+mgmt_client.suppression_lists.create_or_update(
+    resource_group_name,
+    email_service_name,
+    domain_resource_name,
+    suppression_list_resource_name,
+    parameters={
+        "properties": {
+            "listName": ""
         }
     },
 )
@@ -87,13 +103,15 @@ mgmt_client.suppression_list_addresses.create_or_update(
     suppression_list_address_id,
     parameters={
         "properties": {
-            "email": "<email-address-to-suppress>"
+            "email": "<email-address-to-suppress>" # Should match the email address you would like to block from receiving your messages
         }
     },
 )
 ```
 
-You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email won't be sent to the suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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 won't be sent to the suppressed address.
+
+If you try sending an email with a domain that has not been suppressed, you will see that the email successfully sends.
 
 ## Remove an address from a suppression list
 
@@ -109,7 +127,7 @@ 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](./try-send-email.md) or by [using one of the Email SDKs](../send-email.md). Your email will successfully send to the previously suppressed address.
+You can now try sending an email to the suppressed address from the [`TryEmail` section of your Communication Service resource](./try-send-email.md) 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