Merge pull request #56893 from erhopf/speech-regions-update

[CogSvcs] Improving Regions Doc for Speech Services

Author: v-shils

articles/cognitive-services/Speech-Service/how-to-recognize-speech-rest.md

@@ -25,7 +25,7 @@ The REST API is the simplest way to recognize speech if you aren't using a langu
 > Utterances are limited to 15 seconds or less when you use the REST API.
 > Check out the [Speech SDK](how-to-recognize-speech-csharp.md) for recognition of longer utterances.
 
-For more information on the **Speech to Text** REST API, see the [REST APIs](rest-apis.md#speech-to-text) article. To see the API in action, download the [REST API samples](https://github.com/Azure-Samples/SpeechToText-REST) from GitHub.
+For more information on the **Speech to Text** REST API, see the [REST APIs](rest-apis.md#speech-to-text-api) article. To see the API in action, download the [REST API samples](https://github.com/Azure-Samples/SpeechToText-REST) from GitHub.
 
 ## Next steps
 

articles/cognitive-services/Speech-Service/how-to-text-to-speech.md

@@ -87,7 +87,7 @@ If an error occurs, the status codes below are used. The response body for the e
 429|Too Many Requests|You have exceeded the quota or rate of requests allowed for your subscription.
 |502|Bad Gateway	| Network or server-side issue. May also indicate invalid headers.
 
-For more information on the Text to Speech REST API, see [REST APIs](rest-apis.md#text-to-speech).
+For more information on the Text to Speech REST API, see [REST APIs](rest-apis.md#text-to-speech-api).
 
 ## Next steps
 

articles/cognitive-services/Speech-Service/regions.md

@@ -13,31 +13,25 @@ ms.date: 09/24/2018
 ms.author: mahilleb
 ---
 
-# Regions of the Speech Service
+# Speech Service supported regions
 
-The Speech Service is available in different regions.
-When you create a subscription, you can select an available region based on your needs.
+The Speech service allows your application to convert audio to text, perform speech translation, and covert text to speech. The service is available in multiple regions with unique endpoints for the Speech SDK and REST APIs.
 
-When you use your subscription, you have to account for the region you selected.
-
-## REST API
-
-Use the REST API to select the correct region-specific endpoints.
-See [REST APIs](rest-apis.md) for details.
+Make sure that you use the endpoint that matches the region for your subscription.
 
 ## Speech SDK
 
 In the [Speech Service SDK](speech-sdk.md), regions are specified as a string
 (for example, as a parameter to `SpeechConfig.FromSubscription` in the Speech SDK for C#).
 
-### Regions for speech recognition and translation
+### Speech recognition and translation
 
-The following table lists the available regions for **speech recognition** and **translation**.
+The Speech SDK is available in these regions for **speech recognition** and **translation**:
 
   Region | Speech SDK Parameter | Speech Customization Portal
  ------|-------|--------
  West US | `westus` | https://westus.cris.ai
- West US2 | `westus2` | https://westus2.cris.ai 
+ West US2 | `westus2` | https://westus2.cris.ai
  East US | `eastus` | https://eastus.cris.ai
  East US2 | `eastus2` | https://eastus2.cris.ai
  East Asia | `eastasia` | https://eastasia.cris.ai
@@ -46,8 +40,26 @@ The following table lists the available regions for **speech recognition** and *
  West Europe | `westeurope` | https://westeurope.cris.ai
 
 
-### Regions for intent recognition
+### Intent recognition
+
+**Intent recognition** for the Speech SDK shares regions support with LUIS. For a complete list of available regions, see [Publishing regions and endpoints - LUIS](https://docs.microsoft.comazure/cognitive-services/luis/luis-reference-regions)
 
 Available regions for **intent recognition** via the Speech SDK are listed on the [Language Understanding service region page](/azure/cognitive-services/luis/luis-reference-regions).
-For each publishing region listed, the corresponding Speech SDK region parameter is determined as the first part of the domain name of the endpoint.
-For example, use `westus` to specify the West US publishing region.
+
+For each publishing region listed, use the provided **API region name**. For example, use `westus` for West US.
+
+## REST APIs
+
+The Speech service also exposes REST endpoints for speech-to-text and text-to-speech requests.
+
+### Speech-to-text
+
+For speech-to-text reference documentation, see [REST APIs](https://docs.microsoft.com/azure/cognitive-services/speech-service/rest-apis#speech-to-text).
+
+[!INCLUDE [](../../../includes/cognitive-services-speech-service-endpoints-speech-to-text.md)]
+
+### Text-to-speech
+
+For text-to-speech reference documentation, see [REST APIs](https://docs.microsoft.com/azure/cognitive-services/speech-service/rest-apis#speech-to-text).
+
+[!INCLUDE [](../../../includes/cognitive-services-speech-service-endpoints-text-to-speech.md)]