Merge pull request #228033 from boris-bazilevskiy/ech-update

remove date commitment and fix typos and link

Author: v-regandowner

articles/communication-services/concepts/telephony/emergency-calling-concept.md

@@ -19,7 +19,7 @@ ms.subservice: pstn
 
 Azure Communication Calling SDK can be used to add Enhanced Emergency dialing and Public Safety Answering Point (PSAP) call-back support to your applications in the United States (US), Puerto Rico (PR), the United Kingdom (GB), and Canada (CA). The capability to dial 911 (in US, PR, and CA) and 999 or 112 (in GB) and receive a call-back may be a requirement for your application. Verify the Emergency Calling requirements with your legal counsel.
 
-Calls to an emergency number are routed over the Microsoft network. Microsoft assigns a temporary phone number as the Call Line Identity (CLI) when an emergency call from the US, PR, GB, or CA are placed. Microsoft temporarily maintains a mapping of the phone number to the caller's identity. If there is a call-back from the PSAP, we route the call directly to the originating caller. The caller can accept incoming PSAP call even if inbound calling is disabled.
+Calls to an emergency number are routed over the Microsoft network. Microsoft assigns a temporary phone number as the Call Line Identity (CLI) when an emergency call from the US, PR, GB, or CA are placed. Microsoft temporarily maintains a mapping of the phone number to the caller's identity. If there's a call-back from the PSAP, we route the call directly to the originating caller. The caller can accept incoming PSAP call even if inbound calling is disabled.
 
 The service is available for Microsoft phone numbers. It requires that the Azure resource from where the emergency call originates has a Microsoft-issued phone number enabled with outbound dialing (also referred to as ‘make calls').  
 
@@ -31,12 +31,11 @@ Azure Communication Services direct routing is currently in public preview and n
 1. Microsoft validates the Azure resource has a Microsoft phone number enabled for outbound dialing
 1. Microsoft Azure Communication Services emergency service replaces the user’s phone number `alternateCallerId` with a temporary unique phone number. This number allocation remains in place for at least 60 minutes from the time that emergency number is first dialed
 1. Microsoft maintains a temporary record (for approximately 60 minutes) of the user’s identity to the unique phone number
-1. The emergency call will be first routed to a call center where an agent will request the caller’s address
-1. The call center will then route the call to the appropriate PSAP in a proper region
+1. In the US, PR, and CA the emergency call will be first routed to a call center where an agent will request the caller’s address. The call center will then route the call to the appropriate PSAP in a proper region
 1. If the emergency call is unexpectedly dropped, the PSAP then makes a call-back to the user
 1. On receiving the call-back within 60 minutes, Microsoft will route the inbound call directly to the user identity, which initiated the emergency call
 
-## Enabling Emergency calling
+## Enabling Emergency Calling
 
 Emergency dialing is automatically enabled for all users of the Azure Communication Client Calling SDK with an acquired Microsoft telephone number that is enabled for outbound dialing in the Azure resource. To use emergency calling with Microsoft phone numbers, follow the steps:
 
@@ -56,7 +55,7 @@ Emergency dialing is automatically enabled for all users of the Azure Communicat
 
     1. If the caller is outside of the supported countries, the call to 911 won't be permitted
 
-1. When testing your application in the US, dial 933 instead of 911. 933 is enabled for testing purposes; the recorded message will confirm the phone number the emergency call originates from. You should hear a temporary number assigned by Microsoft, which isn't the `alternateCallerId` provided by the application
+1. When testing your application in the US, dial 933 instead of 911. 933 is enabled for testing purposes; the recorded message confirms the phone number the emergency call originates from. You should hear a temporary number assigned by Microsoft, which isn't the `alternateCallerId` provided by the application
 
 1. Ensure your application supports [receiving an incoming call](../../how-tos/calling-sdk/manage-calls.md#receive-an-incoming-call) so call-backs from the PSAP are appropriately routed to the originator of the emergency call. To test inbound calling is working correctly, place inbound VoIP calls to the user of the Calling SDK
 
@@ -65,11 +64,11 @@ The Emergency service is temporarily free to use for Azure Communication Service
 ## Emergency calling with Azure Communication Services direct routing
 
 Emergency call is a regular call from a direct routing perspective. If you want to implement emergency calling with Azure Communication Services direct routing, you need to make sure that there's a routing rule for your emergency number (911, 112, etc.). You also need to make sure that your carrier processes emergency calls properly.
-There's also an option to use purchased number as a caller ID for direct routing calls. In such case, if there's no voice routing rule for emergency number, the call will fall back to Microsoft network, and we'll treat it as a regular emergency call. Learn more about [voice routing fall back](./direct-routing-provisioning.md#outbound-voice-routing-considerations).
+There's also an option to use purchased number as a caller ID for direct routing calls. In such case, if there's no voice routing rule for emergency number, the call falls back to Microsoft network, and we treat it as a regular emergency call. Learn more about [voice routing fall back](./direct-routing-provisioning.md#outbound-voice-routing-considerations).
 
 ## Next steps
 
 ### Quickstarts
 
 - [Outbound call to a phone number](../../quickstarts/telephony/pstn-call.md)
-- [Add Emergency Calling to your app](../../quickstarts/telephony/pstn-call.md)
+- [Add Emergency Calling to your app](../../quickstarts/telephony/emergency-calling.md)

articles/communication-services/quickstarts/telephony/includes/emergency-calling-android.md

@@ -14,17 +14,17 @@ ms.author: zehangzheng
 ## Important considerations
 - The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
-- If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
-- In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
-- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
+- If the country ISO code isn't provided to the SDK, the IP address will be used to determine the country of the caller. 
+- In case IP address can't provide reliable geolocation, for example, the user is on a Virtual Private Network, it's required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
+- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it's required to set the ISO code to the US   
 - Supported ISO codes are US, PR, CA, and GB only
 - Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
-- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in the future.   
 - Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.       
 
 
 ## Setting up
-Replace the code in **app/src/main/res/layout/activity_main.xml** with following snippet. It will add a new button for testing emergency calls.
+Replace the code in **app/src/main/res/layout/activity_main.xml** with following snippet. It adds a new button for testing emergency calls.
 
 ```xml
 <?xml version="1.0" encoding="utf-8"?>
@@ -72,7 +72,7 @@ Replace the code in **app/src/main/res/layout/activity_main.xml** with following
 </androidx.constraintlayout.widget.ConstraintLayout>
 ```
 ## Emergency test call to phone 
-Specify the ISO code of the country where the caller is located. If the ISO code is not provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling.  
+Specify the ISO code of the country where the caller is located. If the ISO code isn't provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling.  
 
 In your **MainActivity.java**, add the following code to your `onCreate` method to retrieve the emergency button you've created in `activity_main.xml`.
 
@@ -103,7 +103,7 @@ private void createAgent() {
 
 ## Start a call to 933 test call service
 
-Add the following code to your **MainActivity.java** to add functionality to your emergency call button. For US only, a temporary Caller Id will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
+Add the following code to your **MainActivity.java** to add functionality to your emergency call button. For US only, a temporary Caller ID will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
 
 ```java
 private void emergencyCall() {
@@ -124,4 +124,4 @@ private void emergencyCall() {
 
 :::image type="content" source="../media/emergency-calling/emergency-calling-android-app.png" alt-text="Screenshot of the completed Android application.":::
 
-The app can now be launched using the "Run App" button on the toolbar (Shift+F10). You can place a call to 933 by clicking the **933 Test Call** button.
+The app can now be launched using the "Run App" button on the toolbar (Shift+F10). You can place a call to 933 by clicking the **933 Test Call** button.

articles/communication-services/quickstarts/telephony/includes/emergency-calling-ios.md

@@ -14,17 +14,17 @@ ms.author: zehangzheng
 ## Important considerations
 - The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
-- If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
-- In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
-- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
+- If the country ISO code isn't provided to the SDK, the IP address will be used to determine the country of the caller. 
+- In case IP address can't provide reliable geolocation, for example, the user is on a Virtual Private Network, it's required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
+- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it's required to set the ISO code to the US   
 - Supported ISO codes are US, PR, CA, and GB only
 - Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
-- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in the future.   
 - Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.    
 
 
 ## Setting up
-Replace the code for `NavigationView` in your **ContentView.swift** with following snippet. It will add a new button for testing emergency calls.
+Replace the code for `NavigationView` in your **ContentView.swift** with following snippet. It adds a new button for testing emergency calls.
 
 ```swift
 NavigationView {
@@ -48,7 +48,7 @@ NavigationView {
 }
 ```
 ## Emergency test call to phone 
-Specify the ISO code of the country where the caller is located. If the ISO code is not provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling.   
+Specify the ISO code of the country where the caller is located. If the ISO code isn't provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling.   
 
 In your **ContentView.swift**, replace your code with the following snippet in your `NavigationView`'s `onAppear` method to specify the emergency country:
 
@@ -85,7 +85,7 @@ self.callClient?.createCallAgent(userCredential: userCredential!, options: callA
 
 ## Start a call to 933 test call service
 
-Add the following code to your **ContentView.swift** to add functionality to your emergency call button. For US only, a temporary Caller Id will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
+Add the following code to your **ContentView.swift** to add functionality to your emergency call button. For US only, a temporary Caller ID will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
 
 ```swift
 func emergencyCall() {
@@ -111,4 +111,4 @@ func emergencyCall() {
 
 :::image type="content" source="../media/emergency-calling/emergency-calling-ios-app.png" alt-text="Screenshot of the completed iOS application.":::
 
-Build and run your app on iOS simulator by selecting **Product** > **Run** or by using the (⌘-R) keyboard shortcut. You can place a call to 933 by clicking the **933 Test Call** button.
+Build and run your app on iOS simulator by selecting **Product** > **Run** or by using the (⌘-R) keyboard shortcut. You can place a call to 933 by clicking the **933 Test Call** button.

articles/communication-services/quickstarts/telephony/includes/emergency-calling-javascript.md

@@ -14,17 +14,17 @@ ms.author: zehangzheng
 ## Important considerations
 - The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
-- If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
-- In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
-- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
+- If the country ISO code isn't provided to the SDK, the IP address will be used to determine the country of the caller. 
+- In case IP address can't provide reliable geolocation, for example, the user is on a Virtual Private Network, it's required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
+- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it's required to set the ISO code to the US   
 - Supported ISO codes are US, PR, CA, and GB only
 - Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
-- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in the future.   
 - Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.
 
 
 ## Setting up
-Replace the code in **index.html** with following snippet. It will add a new button for testing emergency calls.
+Replace the code in **index.html** with following snippet. It adds a new button for testing emergency calls.
 
 ```html
 <!DOCTYPE html>
@@ -58,7 +58,7 @@ Replace the code in **index.html** with following snippet. It will add a new but
 </html>
 ```
 ## Emergency test call to phone 
-Specify the ISO code of the country where the caller is located. If the ISO code is not provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling. 
+Specify the ISO code of the country where the caller is located. If the ISO code isn't provided, the IP address will be used to determine the callers location.  Microsoft uses the ISO 3166-1 alpha-2 standard for country ISO codes, supported ISO codes are listed on the concept page for emergency calling. 
 
 In your **client.js**, add the following code to retrieve the emergency button you've created in index.html.
 
@@ -84,7 +84,7 @@ async function init() {
 
 ## Start a call to 933 test call service
 
-Add the following code to your **client.js** to add functionality to your emergency call button. For US only, a temporary Caller Id will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
+Add the following code to your **client.js** to add functionality to your emergency call button. For US only, a temporary Caller ID will be assigned for your emergency call despite of whether alternateCallerId param is provided or not. 
 
 ```javascript
 emergencyButton.addEventListener("click", () => {