Merge pull request #49752 from GitHubber17/1320921-recognize-speech

edit pass: Cognitive Services recognize speech

Author: ShawnJackson

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

@@ -2,7 +2,7 @@
 title: Recognize speech by using the Speech SDK for C++
 titleSuffix: Microsoft Cognitive Services
 description: |
-  Shows various ways to recognize speech (from file, from microphone, with a customized model, continuously or one-shot) using the Speech SDK for C++.
+  Learn how to recognize speech (from a file, from a microphone, with a customized model, continuously or one-shot) by using the Speech SDK for C++.
 services: cognitive-services
 author: wolfma61
 
@@ -17,26 +17,26 @@ ms.author: wolfma
 
 [!include[Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-selector.md)]
 
-[!include[Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
+[!include[Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
 
-[!include[Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!include[Introduction for top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
 
 [!code-cpp[Top-level declarations](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#toplevel)]
 
-[!include[Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
+[!include[Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
 
-[!code-cpp[Speech Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechRecognitionWithMicrophone)]
+[!code-cpp[Speech recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechRecognitionWithMicrophone)]
 
-[!include[Intro - customized](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
+[!include[Introduction to using customized recognition](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
 
-[!code-cpp[Speech Recognition Using a Customized Model](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechRecognitionUsingCustomizedModel)]
+[!code-cpp[Speech recognition by using a customized model](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechRecognitionUsingCustomizedModel)]
 
-[!include[Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
+[!include[Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
 
-[!code-cpp[Continuous Speech Recognition](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechContinuousRecognitionWithFile)]
+[!code-cpp[Continuous speech recognition](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/speech_recognition_samples.cpp#SpeechContinuousRecognitionWithFile)]
 
 [!include[Download the sample](../../../includes/cognitive-services-speech-service-speech-sdk-sample-download-h2.md)]
-Look for the code in this article in the `samples/cpp/windows/console` folder.
+Look for the code that's used in this article in the samples/cpp/windows/console folder.
 
 ## Next steps
 

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

@@ -2,7 +2,7 @@
 title: 'Recognize speech by using the Speech SDK for C#'
 titleSuffix: Microsoft Cognitive Services
 description: |
-  Shows various ways to recognize speech (from file, from microphone, with a customized model, continuously or one-shot) using the Speech SDK for C#.
+  Learn how to recognize speech (from a file, from a microphone, with a customized model, continuously or one-shot) by using the Speech SDK for C#.
 services: cognitive-services
 author: wolfma61
 
@@ -17,26 +17,26 @@ ms.author: wolfma
 
 [!include[Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-selector.md)]
 
-[!include[Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
+[!include[Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
 
-[!include[Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!include[Introduction for top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
 
 [!code-csharp[Top-level declarations](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#toplevel)]
 
-[!include[Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
+[!include[Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
 
-[!code-csharp[Speech Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionWithMicrophone)]
+[!code-csharp[Speech recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionWithMicrophone)]
 
-[!include[Intro - customized](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
+[!include[Introduction to using customized recognition](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
 
-[!code-csharp[Speech Recognition Using a Customized Model](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionCustomized)]
+[!code-csharp[Speech recognition by using a customized model](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionCustomized)]
 
-[!include[Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
+[!include[Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
 
-[!code-csharp[Continuous Speech Recognition](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionContinuousWithFile)]
+[!code-csharp[Continuous speech recognition](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/speech_recognition_samples.cs#recognitionContinuousWithFile)]
 
 [!include[Download the sample](../../../includes/cognitive-services-speech-service-speech-sdk-sample-download-h2.md)]
-Look for the code in this article in the `samples/csharp/sharedcontent/console` folder.
+Look for the code that's used in this article in the samples/csharp/sharedcontent/console folder.
 
 ## Next steps
 

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

@@ -2,7 +2,7 @@
 title: Recognize speech by using the Speech SDK for Java
 titleSuffix: Microsoft Cognitive Services
 description: |
-  Shows various ways to recognize speech (from file, from microphone, with a customized model, continuously or one-shot) using the Speech SDK for Java.
+  Learn how to recognize speech (from a file, from a microphone, with a customized model, continuously or one-shot) by using the Speech SDK for Java.
 services: cognitive-services
 author: wolfma61
 
@@ -17,25 +17,26 @@ ms.author: wolfma
 
 [!include[Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-selector.md)]
 
-[!include[Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
+[!include[Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md)]
 
-[!include[Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!include[Introduction for top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
 
 [!code-java[Top-level declarations](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#toplevel)]
 
-[!include[Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
+[!include[Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md)]
 
-[!code-java[Speech Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionWithMicrophone)]
+[!code-java[Speech recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionWithMicrophone)]
 
-[!include[Intro - customized](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
+[!include[Introduction to using customized recognition](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md)]
 
-[!code-java[Speech Recognition Using a Customized Model](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionCustomized)]
+[!code-java[Speech recognition by using a customized model](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionCustomized)]
 
-[!include[Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
+[!include[Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md)]
 
-[!code-java[Continuous Speech Recognition](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionContinuousWithFile)]
+[!code-java[Continuous speech recognition](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/SpeechRecognitionSamples.java#recognitionContinuousWithFile)]
 
 [!include[Download the sample](../../../includes/cognitive-services-speech-service-speech-sdk-sample-download-h2.md)]
+Look for the code that's used in this article in the samples/java/jre/console folder.
 
 ## Next steps
 

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

@@ -1,6 +1,6 @@
 ---
 title: Recognize speech by using the REST API
-description: Learn how to use Speech to Text in the Speech service
+description: Learn how to use the Speech to Text API in the Cognitive Services Speech service.
 titleSuffix: Microsoft Cognitive Services
 services: cognitive-services
 author: v-jerkin
@@ -16,17 +16,16 @@ ms.author: v-jerkin
 
 [!include[Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-speech-selector.md)]
 
-The REST API can be used to recognize short utterances using an HTTP POST request.
+The REST API can be used to recognize short utterances by using an HTTP POST request.
 
-The REST API is the simplest way to recognize speech if you are not using a language supported by the [SDK](speech-sdk.md).
-You can make an HTTP POST request to the service endpoint, pass the entire utterance in the body of the request; and you'll receive a response containing the recognized text.
+The REST API is the simplest way to recognize speech if you aren't using a language that's supported by the [SDK](speech-sdk.md). You make an HTTP POST request to the service endpoint and pass the entire utterance in the body of the request. You receive a response that has the recognized text.
 
 > [!NOTE]
-> Utterances are limited to 15 seconds or less when using the REST API.
+> 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 [REST APIs](rest-apis.md#speech-to-text). To see it 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) article. To see the API in action, download the [REST API samples](https://github.com/Azure-Samples/SpeechToText-REST) from GitHub.
 
 ## Next steps
 
-- [See the REST API overview](rest-apis.md)
+- See the [REST API overview](rest-apis.md).

includes/cognitive-services-speech-service-get-subscription-key.md

@@ -7,5 +7,4 @@ ms.author: wolfma
 ---
 
 > [!NOTE]
-> Please obtain a subscription key first.
-> See [Try the speech service for free](~/articles/cognitive-services/speech-service/get-started.md).
+> First, obtain a subscription key. For more information, see [Try the Speech service for free](~/articles/cognitive-services/speech-service/get-started.md).

includes/cognitive-services-speech-service-how-to-recognize-speech-continuous.md

@@ -8,7 +8,7 @@ ms.author: wolfma
 
 ## Continuous speech recognition from a file
 
-The following code snippet continuously recognizes speech input from an audio file in the default language (`en-US`), the supported format is single-channel (mono) WAV / PCM with a sampling rate of 16 kHz.
+The following code snippet continuously recognizes speech input from an audio file in the default language (en-US). The supported format is single-channel (mono) WAV / PCM with a sampling rate of 16 kHz.
 
-[!include[Sample Audio](cognitive-services-speech-service-sample-audio.md)]
+[!include[Sample audio](cognitive-services-speech-service-sample-audio.md)]
 

includes/cognitive-services-speech-service-how-to-recognize-speech-customized.md

@@ -6,8 +6,7 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Speech recognition using a customized model
+## Speech recognition with a customized model
 
-The [Custom Speech Service (CRIS)](https://www.cris.ai/) allows the customization of the Microsoft's speech-to-text engine for your application.
-The snippet below shows how to recognize speech from a microphone using your CRIS model;
-fill in your CRIS subscription key and your own deployment identification before running it.
+The [Custom Speech service (CRIS)](https://www.cris.ai/) allows the customization of the Microsoft speech-to-text engine for your application.
+The following code snippet shows how to recognize speech from a microphone by using your CRIS model. Fill in your CRIS subscription key and your own deployment identification before you run the code.

includes/cognitive-services-speech-service-how-to-recognize-speech-intro.md

@@ -8,16 +8,16 @@ ms.author: wolfma
 
 <!-- N.B. no header, no intents here, language-agnostic -->
 
-The [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides the simplest way to use **Speech to Text** in your application with full functionality.
+The Cognitive Services [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides the simplest way to use **Speech to Text** in your application with full functionality.
 
-1. Create a speech factory, providing a Speech service subscription key or an authorization token, and a [region](~/articles/cognitive-services/speech-service/regions.md). You can also specify a custom endpoint to specify a non-standard service endpoint.
+1. Create a speech factory and provide a Speech service subscription key (or an authorization token) and a [region](~/articles/cognitive-services/speech-service/regions.md) as parameters. You can also provide a custom endpoint to specify a non-standard service endpoint.
 
-1. Get a speech recognizer from the speech factory. You can configure the input language as well as the output format.  A recognizer can use your device's default microphone, an audio stream, or audio from a file.
+1. Get a speech recognizer from the speech factory. You can configure the input language and the output format. A recognizer can use your device's default microphone, an audio stream, or audio from a file.
 
-1. Tie up the events for asynchronous operation, if desired. The recognizer then calls your event handlers when it has interim and final results.  Otherwise, your application will receive a final transcription result.
+1. Tie up the events for asynchronous operation, if desired. The recognizer then calls your event handlers when it has interim and final results. Otherwise, your application receives only a final transcription result.
 
-1. Start recognition. For single-shot recognition, like command or query recognition, use `RecognizeAsync()`, which returns the first utterance being recognized. For long-running recognition, like transcription, use `StartContinuousRecognitionAsync()` and tie up the events for asynchronous recognition results.
+1. Start recognition. For single-shot recognition, such as command or query recognition, use the `RecognizeAsync()` method. This method returns the first recognized utterance. For long-running recognition like transcription, use the `StartContinuousRecognitionAsync()` method. Tie up the events for asynchronous recognition results.
 
-See the code snippets below for speech recognition scenarios using the Speech SDK.
+See the following code snippets for speech recognition scenarios that use the Speech SDK.
 
-[!include[Get a Subscription Key](cognitive-services-speech-service-get-subscription-key.md)]
+[!include[Get a subscription key](cognitive-services-speech-service-get-subscription-key.md)]

includes/cognitive-services-speech-service-how-to-recognize-speech-microphone.md

@@ -6,7 +6,7 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Speech recognition using the microphone
+## Speech recognition from a microphone
 
-The code snippet below shows how to recognize speech input from the microphone in the default language (`en-US`).
+The following code snippet shows how to recognize speech input from a microphone in the default language (en-US).