Skip to content

Commit 87cfeba

Browse files
author
Yogesh Mohanraj
committed
Improving documentation clarity
1 parent 4188c29 commit 87cfeba

File tree

4 files changed

+29
-32
lines changed

4 files changed

+29
-32
lines changed

articles/communication-services/quickstarts/email/includes/add-multiple-senders-java.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ ms.custom: mode-other
1414
## Prerequisites
1515

1616
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
17-
- An Azure Email Communication Services Resource created and ready to provision the domains [Get started with Creating Email Communication Resource](../create-email-communication-resource.md)
18-
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready.
19-
- We will be 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 environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
17+
- An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
18+
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
19+
- We will be 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`.
2020

2121
## Install the required packages
2222

@@ -32,7 +32,7 @@ Add the following dependency to your `pom.xml`.
3232

3333
## Initialize the management client
3434

35-
To initialize your client, intialize the environment variable `AZURE_SUBSCRIPTION_ID` with your subscription id before running the code sample.
35+
Set the environment variable `AZURE_SUBSCRIPTION_ID` with the subscription id of the subscription your Domain and Email resources are in. Run the code sample below to initialize the management client.
3636

3737
```java
3838
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
@@ -45,10 +45,9 @@ CommunicationManager manager = CommunicationManager
4545

4646
## Add sender usernames
4747

48-
When Email Domain is provisioned to send mail, it has default MailFrom address as [email protected] or
49-
if you have configured custom domain such as "notification.azuremails.net" then the default MailFrom address as "[email protected]" added. You can configure and add additional MailFrom addresses and FROM display name to more user friendly value.
48+
When a Azure Managed Domain resource is provisioned, the MailFrom address defaults to [email protected]. If you have configured a custom domain such as "notification.azurecommtest.net" the MailFrom address defaults to "[email protected]".
5049

51-
The username you are configuring is the user alias that will be used in your MailFrom address. For example, [email protected] would be the new MailFrom address.
50+
The username is the user alias that is used in the MailFrom address. For example, the username in the MailFrom address `[email protected]` would be `contosoNewsAlerts`. You can add additional sender usenames, which can also be configured with a more user friendly display name. In our example, the display name is `Contoso News Alerts`.
5251

5352
Update the code sample below with the resource group name, the email service name, and the domain name that you would like to add this username to. 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 will be `<your-email-service-name>/<your-domain-name>`. The resource group name can be found in the Essentials sections in the domain resource Overview blade.
5453

@@ -89,7 +88,7 @@ manager
8988

9089
* [Get started by connecting Email Communication Service with a Azure Communication Service resource](../connect-email-communication-resource.md)
9190

92-
The following documents may be interesting to you:
91+
The following documents may interest you:
9392

9493
- Familiarize yourself with the [Email client library](../../../concepts/email/sdk-features.md)
9594
- How to send emails with custom verified domains?[Add custom domains](../add-custom-verified-domains.md)

articles/communication-services/quickstarts/email/includes/add-multiple-senders-js.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ ms.custom: mode-other
1414
## Prerequisites
1515

1616
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
17-
- An Azure Email Communication Services Resource created and ready to provision the domains [Get started with Creating Email Communication Resource](../create-email-communication-resource.md)
18-
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready.
19-
- We will be 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 environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
17+
- An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
18+
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
19+
- We will be 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`.
2020

2121
## Install the required packages
2222

@@ -27,7 +27,7 @@ npm install @azure/identity
2727

2828
## Initialize the management client
2929

30-
To initialize your client, replace the field in the sample code below with your subscription id.
30+
Replace the field in the sample code below with the subscription id of the subscription your Domain and Email resources are in. Run the code sample below to initialize the management client.
3131

3232
```javascript
3333
const { CommunicationServiceManagementClient } = require("@azure/arm-communication");
@@ -41,10 +41,9 @@ mgmtClient = new CommunicationServiceManagementClient(credential, subscriptionId
4141

4242
## Add sender usernames
4343

44-
When Email Domain is provisioned to send mail, it has default MailFrom address as [email protected] or
45-
if you have configured custom domain such as "notification.azuremails.net" then the default MailFrom address as "[email protected]" added. You can configure and add additional MailFrom addresses and FROM display name to more user friendly value.
44+
When a Azure Managed Domain resource is provisioned, the MailFrom address defaults to [email protected]. If you have configured a custom domain such as "notification.azurecommtest.net" the MailFrom address defaults to "[email protected]".
4645

47-
You can define the username you want to add in a parameters object. The username you are configuring is the user alias that will be used in your MailFrom address. For example, [email protected] would be the new MailFrom address.
46+
The username is the user alias that is used in the MailFrom address. For example, the username in the MailFrom address `[email protected]` would be `contosoNewsAlerts`. You can add additional sender usenames, which can also be configured with a more user friendly display name. In our example, the display name is `Contoso News Alerts`.
4847

4948
Update the code sample below with the resource group name, the email service name, and the domain name that you would like to add this username to. 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 will be `<your-email-service-name>/<your-domain-name>`. The resource group name can be found in the Essentials sections in the domain resource Overview blade.
5049

@@ -88,7 +87,7 @@ await mgmtClient.senderUsernames.delete(
8887

8988
* [Get started by connecting Email Communication Service with a Azure Communication Service resource](../connect-email-communication-resource.md)
9089

91-
The following documents may be interesting to you:
90+
The following documents may interest you:
9291

9392
- Familiarize yourself with the [Email client library](../../../concepts/email/sdk-features.md)
9493
- How to send emails with custom verified domains?[Add custom domains](../add-custom-verified-domains.md)

articles/communication-services/quickstarts/email/includes/add-multiple-senders-net.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,10 @@ ms.custom: mode-other
1414
## Prerequisites
1515

1616
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
17-
- An Azure Email Communication Services Resource created and ready to provision the domains [Get started with Creating Email Communication Resource](../create-email-communication-resource.md)
18-
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready.
19-
- We will be 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 environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
17+
- An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
18+
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
19+
- We will be 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`.
20+
2021
## Install the required packages
2122

2223
```console
@@ -25,7 +26,7 @@ dotnet add package Azure.ResourceManager.Communication
2526

2627
## Initialize the management client
2728

28-
To initialize your client, intialize the environment variable `AZURE_SUBSCRIPTION_ID` with your subscription id before running the code sample.
29+
Set the environment variable `AZURE_SUBSCRIPTION_ID` with the subscription id of the subscription your Domain and Email resources are in. Run the code sample below to initialize the management client.
2930

3031
```csharp
3132
using System;
@@ -41,10 +42,9 @@ ArmClient client = new ArmClient(new DefaultAzureCredential());
4142

4243
## Add sender usernames
4344

44-
When Email Domain is provisioned to send mail, it has default MailFrom address as [email protected] or
45-
if you have configured custom domain such as "notification.azuremails.net" then the default MailFrom address as "[email protected]" added. You can configure and add additional MailFrom addresses and FROM display name to more user friendly value.
45+
When a Azure Managed Domain resource is provisioned, the MailFrom address defaults to [email protected]. If you have configured a custom domain such as "notification.azurecommtest.net" the MailFrom address defaults to "[email protected]".
4646

47-
You can define the username you want to add in a SenderUsernameResourceData object. The username you are configuring is the user alias that will be used in your MailFrom address. For example, [email protected] would be the new MailFrom address.
47+
The username is the user alias that is used in the MailFrom address. For example, the username in the MailFrom address `[email protected]` would be `contosoNewsAlerts`. You can add additional sender usenames, which can also be configured with a more user friendly display name. In our example, the display name is `Contoso News Alerts`.
4848

4949
Update the code sample below with the resource group name, the email service name, and the domain name that you would like to add this username to. 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 will be `<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 blade.
5050

@@ -82,7 +82,7 @@ await senderUsernameResource.DeleteAsync(WaitUntil.Completed);
8282

8383
* [Get started by connecting Email Communication Service with a Azure Communication Service resource](../connect-email-communication-resource.md)
8484

85-
The following documents may be interesting to you:
85+
The following documents may interest you:
8686

8787
- Familiarize yourself with the [Email client library](../../../concepts/email/sdk-features.md)
8888
- How to send emails with custom verified domains?[Add custom domains](../add-custom-verified-domains.md)

articles/communication-services/quickstarts/email/includes/add-multiple-senders-python.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ ms.custom: mode-other
1414
## Prerequisites
1515

1616
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/dotnet/).
17-
- An Azure Email Communication Services Resource created and ready to provision the domains [Get started with Creating Email Communication Resource](../create-email-communication-resource.md)
18-
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready.
19-
- We will be 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 environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, and `AZURE_CLIENT_SECRET`.
17+
- An Azure Email Communication Services Resource ready to provision domains. [Get started creating an Email Communication Resource](../create-email-communication-resource.md).
18+
- An [Azure Managed Domain](../add-azure-managed-domains.md) or [Custom Domain](../add-custom-verified-domains.md) provisioned and ready to send emails.
19+
- We will be 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`.
2020

2121
## Install the required packages
2222

@@ -27,7 +27,7 @@ pip install azure-identity
2727

2828
## Initialize the management client
2929

30-
To initialize your client, replace the field in the sample code below with your subscription id.
30+
Replace the field in the sample code below with the subscription id of the subscription your Domain and Email resources are in. Run the code sample below to initialize the management client.
3131

3232
```python
3333
from azure.mgmt.communication import CommunicationServiceManagementClient
@@ -41,10 +41,9 @@ mgmt_client = CommunicationServiceManagementClient(credential, subscription_id)
4141

4242
## Add sender usernames
4343

44-
When Email Domain is provisioned to send mail, it has default MailFrom address as [email protected] or
45-
if you have configured custom domain such as "notification.azuremails.net" then the default MailFrom address as "[email protected]" added. You can configure and add additional MailFrom addresses and FROM display name to more user friendly value.
44+
When a Azure Managed Domain resource is provisioned, the MailFrom address defaults to [email protected]. If you have configured a custom domain such as "notification.azurecommtest.net" the MailFrom address defaults to "[email protected]".
4645

47-
You can define the username you want to add in a parameters object. The username you are configuring is the user alias that will be used in your MailFrom address. For example, [email protected] would be the new MailFrom address.
46+
The username is the user alias that is used in the MailFrom address. For example, the username in the MailFrom address `[email protected]` would be `contosoNewsAlerts`. You can add additional sender usenames, which can also be configured with a more user friendly display name. In our example, the display name is `Contoso News Alerts`.
4847

4948
Update the code sample below with the resource group name, the email service name, and the domain name that you would like to add this username to. 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 will be `<your-email-service-name>/<your-domain-name>`. The resource group name can be found in the Essentials sections in the domain resource Overview blade.
5049

@@ -88,7 +87,7 @@ mgmt_client.sender_usernames.delete(
8887

8988
* [Get started by connecting Email Communication Service with a Azure Communication Service resource](../connect-email-communication-resource.md)
9089

91-
The following documents may be interesting to you:
90+
The following documents may interest you:
9291

9392
- Familiarize yourself with the [Email client library](../../../concepts/email/sdk-features.md)
9493
- How to send emails with custom verified domains?[Add custom domains](../add-custom-verified-domains.md)

0 commit comments

Comments
 (0)