edit pass: communication-services-telephony

Author: ShawnJackson

articles/communication-services/how-tos/telephony/domain-validation.md

@@ -1,6 +1,6 @@
 ---
 title: Azure Communication Services direct routing domain validation
-description: A how-to page about domain validation for direct routing.
+description: Learn how to validate a domain for direct routing.
 services: azure-communication-services
 author: boris-bazilevskiy
 
@@ -12,54 +12,50 @@ ms.custom: include file
 ms.author: nikuklic
 ---
 
-# Domain validation
+# Validate a domain for direct routing
 
-This page describes the process of domain name ownership validation. Fully Qualified Domain Name (FQDN) consists of two parts: host name and domain name. For example, if your session border controller (SBC) name is `sbc1.contoso.com`, then `sbc1` would be a host name, while `contoso.com` would be a domain name. If there's an SBC with FQDN of `acs.sbc1.testing.contoso.com`, `acs` would be a host name, and `sbc1.testing.contoso.com` would be a domain name. To use direct routing, you need to validate that you own a domain part of your FQDN.
+This article describes the process of validating domain name ownership. A fully qualified domain name (FQDN) consists of two parts: host name and domain name. For example, if your session border controller (SBC) name is `sbc1.contoso.com`, then `sbc1` would be a host name and `contoso.com` would be a domain name. If there's an SBC with FQDN of `acs.sbc1.testing.contoso.com`, `acs` is a host name and `sbc1.testing.contoso.com` is a domain name. To use direct routing, you need to validate that you own the domain part of your FQDN.
 
-Azure Communication Services direct routing configuration consists of the following steps:
+To configure direct routing configuration in Azure Communication Services, you first verify domain ownership for your SBC FQDN. You then configure the SBC FQDN and port number and create voice routing rules.
 
-- Verify domain ownership for your SBC FQDN
-- Configure SBC FQDN and port number
-- Create voice routing rules
+## Validate domain ownership by using the Azure portal
 
-## Domain ownership validation
+When you're verifying the domain name portion of the FQDN, keep in mind that the `*.onmicrosoft.com` and `*.azure.com` domain names aren't supported for the SBC FQDN domain name. For example, if you have two domain names, `contoso.com` and `contoso.onmicrosoft.com`, use `sbc.contoso.com` as the SBC name.
 
-Make sure to add and verify domain name portion of the FQDN and keep in mind that the `*.onmicrosoft.com` and `*.azure.com` domain names aren't supported for the SBC FQDN domain name. For example, if you have two domain names, `contoso.com` and `contoso.onmicrosoft.com`, use `sbc.contoso.com` as the SBC name. If using a subdomain, make sure this subdomain is also added and verified. For example, if you want to use `sbc.acs.contoso.com`, then `acs.contoso.com` needs to be registered.
+If you're using a subdomain, make sure that this subdomain is also added and verified. For example, if you want to use `sbc.acs.contoso.com`, you need to register `acs.contoso.com`.
 
-### Domain verification using Azure portal
+### Add a new domain name
 
-#### Add new domain name
-
-1. Open Azure portal and navigate to your [Communication Service resource](../../quickstarts/create-communication-resource.md).
-1. In the left navigation pane, select Direct routing under Voice Calling - PSTN.
-1. Select Connect domain from the Domains tab.
-1. Enter the domain part of SBC’s fully qualified domain name.
+1. Open the Azure portal and go to your [Communication Services resource](../../quickstarts/create-communication-resource.md).
+1. On the left pane, under **Voice Calling - PSTN**, select **Direct routing**.
+1. On the **Domains** tab, select **Connect domain**.
+1. Enter the domain part of the SBC FQDN.
 1. Reenter the domain name.
-1. Select Confirm and then select Add.
+1. Select **Confirm**, and then select **Add**.
 
 [![Screenshot of adding a custom domain.](./media/direct-routing-add-domain.png)](./media/direct-routing-add-domain.png#lightbox)
 
-#### Verify domain ownership
+### Verify domain ownership
 
 1. Select Verify next to new domain that is now visible in Domain’s list.
 1. Azure portal generates a value for a TXT record, you need to add that record to
 
-[![Screenshot of verifying a custom domain.](./media/direct-routing-verify-domain-2.png)](./media/direct-routing-verify-domain-2.png#lightbox)
+   [![Screenshot of verifying a custom domain.](./media/direct-routing-verify-domain-2.png)](./media/direct-routing-verify-domain-2.png#lightbox)
 
->[!Note] 
->It might take up to 30 minutes for new DNS record to propagate on the Internet
+   >[!NOTE]
+   >It might take up to 30 minutes for new DNS record to propagate on the Internet
 
-3. Select Next. If everything is set up correctly, you should see Domain status changed to *Verified* next to the added domain.
+1. Select Next. If everything is set up correctly, you should see Domain status changed to *Verified* next to the added domain.
 
-[![Screenshot of a verified domain.](./media/direct-routing-domain-verified.png)](./media/direct-routing-domain-verified.png#lightbox)
+   [![Screenshot of a verified domain.](./media/direct-routing-domain-verified.png)](./media/direct-routing-domain-verified.png#lightbox)
 
-#### Remove domain from Azure Communication Services
+### Remove a domain from Azure Communication Services
 
 If you want to remove a domain from your Azure Communication Services direct routing configuration, select the checkbox fir a corresponding domain name, and select *Remove*.
 
 [![Screenshot of removing a custom domain.](./media/direct-routing-remove-domain.png)](./media/direct-routing-remove-domain.png#lightbox)
 
-## Next steps:
+## Next steps
 
 ### Conceptual documentation
 

articles/communication-services/quickstarts/telephony/includes/voice-routing-sdk-jscript.md

@@ -1,6 +1,6 @@
 ---
 title: include file
-description: A quickstart on how to use Number Management JavaScript SDK to configure direct routing.
+description: Learn how to use the Number Management JavaScript SDK to configure direct routing.
 services: azure-communication-services
 author: boris-bazilevskiy
 
@@ -15,29 +15,30 @@ ms.author: nikuklic
 ## Prerequisites
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- An active Communication Services resource and connection string. [Create a Communication Services resource](../../create-communication-resource.md)).
-- Active LTS and Maintenance LTS versions of  [Node.js](https://nodejs.org/) for your operating system.
-- Fully Qualified Domain Name (FQDN) and port number of a Session Border Controller (SBC) in operational telephony system.
-- [Verified domain name](../../../how-tos/telephony/domain-validation.md) of the SBC FQDN.
+- An active Azure Communication Services resource and connection string. [Create a Communication Services resource](../../create-communication-resource.md).
+- Active LTS and Maintenance LTS versions of [Node.js](https://nodejs.org/) for your operating system.
+- The fully qualified domain name (FQDN) and port number of a session border controller (SBC) in an operational telephony system.
+- The [verified domain name](../../../how-tos/telephony/domain-validation.md) of the SBC FQDN.
 
 ## Final code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/direct-routing-quickstart)
+Find the finalized code for the following procedures on [GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/direct-routing-quickstart).
 
 ## Create a new Node.js application
 
-First, open your terminal or command window, create a new directory for your app, and navigate to it.
+First, open your terminal or command window, create a new directory for your app, and go to it:
 
 ``` console
     mkdir direct-routing-quickstart && cd direct-routing-quickstart
 ```
 
-Run npm `init -y` to create a package.json file with default settings.
+Run npm `init -y` to create a *package.json* file with default settings.
 
 ``` console
    npm init -y
 ```
-Create a file called direct-routing-quickstart.js in the root of the directory you created. Add the following snippet to it:
+
+Create a file called *direct-routing-quickstart.js* in the root of the directory that you created. Add the following snippet to it:
 
 ``` javascript
 async function main() {
@@ -49,19 +50,19 @@ main();
 
 ## Install the package
 
-Use `npm install` command to install the Azure Communication Services Phone Numbers client library for JavaScript.
+Use the `npm install` command to install the Azure Communication Services Phone Numbers client library for JavaScript:
 
 ``` console
 	npm install @azure/communication-phone-numbers --save
 ```
 
-The `--save` option adds the library as a dependency in your package.json file.
+The `--save` option adds the library as a dependency in your *package.json* file.
 
 ## Authenticate the client
 
-Import the `SipRoutingClient` from the client library and instantiate it with your connection string. The code retrieves the connection string for the resource from an environment variable named `COMMUNICATION_SERVICES_CONNECTION_STRING`. Learn how to [manage your resource's connection string](../../create-communication-resource.md#store-your-connection-string).
+Import `SipRoutingClient` from the client library and instantiate it with your connection string. The code retrieves the connection string for the resource from an environment variable named `COMMUNICATION_SERVICES_CONNECTION_STRING`. [Learn how to manage your resource's connection string](../../create-communication-resource.md#store-your-connection-string).
 
-Add the following code to the `direct-routing-quickstart.js`:
+Add the following code to *direct-routing-quickstart.js*:
 
 ```javascript
 const { SipRoutingClient } = require('@azure/communication-phone-numbers');
@@ -74,15 +75,13 @@ const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING']
 const sipRoutingClient = new SipRoutingClient(connectionString);
 ```
 
-## Setup direct routing configuration
+## Set up a direct routing configuration
 
-1. Domain ownership verification - see [prerequisites](#prerequisites)
-1. Creating trunks (adding SBCs)
-1. Creating voice routes
+In the [prerequisites](#prerequisites), you verified domain ownership. The next steps are to create trunks (add SBCs) and create voice routes.
 
-### Create or update Trunks
+### Create or update trunks
 
-Azure Communication Services direct routing allows communication with registered SBCs only. To register an SBC, you need its FQDN and port.
+Azure Communication Services direct routing allows communication with registered SBCs only. To register an SBC, you need its FQDN and port:
 
 ```javascript
   await client.setTrunks([
@@ -96,12 +95,12 @@ Azure Communication Services direct routing allows communication with registered
   ]);
 ```
 
-### Create or update Routes
+### Create or update routes
 
 > [!NOTE]
-> Order of routes does matter, as it determines priority of routes. The first route that matches the regex will be picked for a call.
+> The order of routes determines the priority of routes. The first route that matches the regex will be picked for a call.
 
-For outbound calling routing rules should be provided. Each rule consists of two parts: regex pattern that should match dialed phone number and FQDN of a registered trunk where call is routed. In this example, we create one route for numbers that start with `+1` and a second route for numbers that start with just `+`.
+Provide routing rules for outbound calls. Each rule consists of two parts: a regex pattern that should match a dialed phone number and the FQDN of a registered trunk where call is routed. In this example, you create one route for numbers that start with `+1` and a second route for numbers that start with just `+`:
 
 ```javascript
    await client.setRoutes([
@@ -119,22 +118,23 @@ For outbound calling routing rules should be provided. Each rule consists of two
   ]);
 ```
 
-### Updating existing configuration
+## Update a direct routing configuration
 
-Properties of specific Trunk can be updated by overwriting the record with the same FQDN. For example, you can set new SBC Port value.
+You can update the properties of a specific trunk by overwriting the record with the same FQDN. For example, you can set new SBC port value:
 
 ``` javascript
   await client.setTrunk({
     fqdn: 'sbc.us.contoso.com',
     sipSignalingPort: 5063
   });
 ```
+
 > [!IMPORTANT]
->The same method is used to create and update routing rules. When updating routes, all routes should be sent in single update and routing configuration will be fully overwritten by the new one. 
+>You use the same method to create and update routing rules. When you update routes, send all of them in a single update. The new routing configuration fully overwrites the former one.
 
-### Removing a direct routing configuration
+## Remove a direct routing configuration
 
-You can't edit or remove single voice route. Entire voice routing configuration should be overwritten. Here's the example of an empty list that removes all the routes and trunks:
+You can't edit or remove a single voice route. You should overwrite the entire voice routing configuration. Here's an example of an empty list that removes all the routes and trunks:
 
 ``` javascript
 //delete all configured voice routes
@@ -144,23 +144,21 @@ await client.setRoutes([]);
 //delete all trunks
 console.log("Deleting all trunks...");
 await client.setTrunks([]);
-``` 
+```
 
-You can delete a single trunk (SBC), if it isn't used in any voice route. If SBC is listed in any voice route, that route should be deleted first.
+You can use the following example to delete a single trunk (SBC), if no voice routes are using it. If the SBC is listed in any voice route, delete that route first.
 
 ``` javascript
    await client.deleteTrunk('sbc.us.contoso.com');
 ```
 
-<!-- All Direct Routing configuration can be deleted by overriding routes and trunks configudation with new configuration or empty lists. Same methods are used as in "Create or Update Trunks" and "Create or Update Routes" sections. -->
-
-### Run the code
+## Run the code
 
-Use the node command to run the code you added to the `direct-routing-quickstart.js` file.
+Use the node command to run the code that you added to the `direct-routing-quickstart.js` file:
 
 ``` console
 	node direct-routing-quickstart.js
 ```
 
 > [!NOTE]
-> More usage examples for SipRoutingClient can be found [here](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/communication/azure-communication-phonenumbers/src/samples/java/com/azure/communication/phonenumbers/siprouting/AsyncClientJavaDocCodeSnippets.java).
+> You can find more usage examples for `SipRoutingClient` on [GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/communication/azure-communication-phonenumbers/src/samples/java/com/azure/communication/phonenumbers/siprouting/AsyncClientJavaDocCodeSnippets.java).