Merge pull request #49400 from GitHubber17/1320921-intents-speech-cpp

edit pass: Cognitive Services Speech SDK intents

Author: ShawnJackson

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

@@ -2,7 +2,7 @@
 title: Recognize intents from speech by using the Speech SDK for C++
 titleSuffix: "Microsoft Cognitive Services"
 description: |
-  Shows various ways to recognize intents from speech (from file, from microphone) using the Speech SDK for C++.
+  Learn how to recognize intents from speech from a file or a microphone by using the Speech SDK for C++.
 services: cognitive-services
 author: wolfma61
 
@@ -15,28 +15,28 @@ ms.author: wolfma
 
 # Recognize intents from speech by using the Speech SDK for C++
 
-[!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
+[!INCLUDE [Article selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-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/intent_recognition_samples.cpp#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
 
-[!code-cpp[Intent Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentRecognitionWithMicrophone)]
+[!code-cpp[Intent recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentRecognitionWithMicrophone)]
 
-[!INCLUDE [Intro - using microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
+[!INCLUDE [Introduction to using a microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
 
-[!code-cpp[Intent Recognition Using Microphone In A Specified Language](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentRecognitionWithLanguage)]
+[!code-cpp[Intent recognition by using a microphone in a specified language](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentRecognitionWithLanguage)]
 
-[!INCLUDE [Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
+[!INCLUDE [Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
 
-[!code-cpp[Intent Recognition Using Events From a File](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentContinuousRecognitionWithFile)]
+[!code-cpp[Intent recognition by using events from a file](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/intent_recognition_samples.cpp#IntentContinuousRecognitionWithFile)]
 
 [!INCLUDE [Get the samples](../../../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-intents-from-speech-csharp.md

@@ -1,8 +1,8 @@
 ---
-title: 'Recognize intents from speech by using the Speech SDK for C#'
+title: Recognize intents from speech by using the Speech SDK for C#
 titleSuffix: "Microsoft Cognitive Services"
 description: |
-  Shows various ways to recognize intents from speech (from file, from microphone) using the Speech SDK for C#.
+  Learn how to recognize intents from speech from a file or a microphone by using the Speech SDK for C#.
 services: cognitive-services
 author: wolfma61
 
@@ -15,28 +15,28 @@ ms.author: wolfma
 
 # Recognize intents from speech by using the Speech SDK for C#
 
-[!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
+[!INCLUDE [Article selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-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/intent_recognition_samples.cs#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
 
-[!code-csharp[Intent Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentRecognitionWithMicrophone)]
+[!code-csharp[Intent recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentRecognitionWithMicrophone)]
 
-[!INCLUDE [Intro - using microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
+[!INCLUDE [Introduction - using microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
 
-[!code-csharp[Intent Recognition Using Microphone In A Specified Language](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentRecognitionWithLanguage)]
+[!code-csharp[Intent recognition by using a microphone in a specified language](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentRecognitionWithLanguage)]
 
-[!INCLUDE [Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
+[!INCLUDE [Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
 
-[!code-csharp[Intent Recognition Using Events From a File](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentContinuousRecognitionWithFile)]
+[!code-csharp[Intent recognition by using events from a file](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/intent_recognition_samples.cs#intentContinuousRecognitionWithFile)]
 
 [!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-intents-from-speech-java.md

@@ -2,7 +2,7 @@
 title: Recognize intents from speech by using the Speech SDK for Java
 titleSuffix: "Microsoft Cognitive Services"
 description: |
-  Shows various ways to recognize intents from speech (from file, from microphone) using the Speech SDK for Java.
+  Learn how to recognize intents from speech from a file or a microphone by using the Speech SDK for Java.
 services: cognitive-services
 author: wolfma61
 
@@ -15,27 +15,28 @@ ms.author: wolfma
 
 # Recognize intents from speech by using the Speech SDK for Java
 
-[!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
+[!INCLUDE [Article selector](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-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/IntentRecognitionSamples.java#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone.md)]
 
-[!code-java[Intent Recognition Using Microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentRecognitionWithMicrophone)]
+[!code-java[Intent recognition by using a microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentRecognitionWithMicrophone)]
 
-[!INCLUDE [Intro - using microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
+[!INCLUDE [Introduction to using a microphone and language](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-microphone-language.md)]
 
-[!code-java[Intent Recognition Using Microphone In A Specified Language](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentRecognitionWithLanguage)]
+[!code-java[Intent recognition by using a microphone in a specified language](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentRecognitionWithLanguage)]
 
-[!INCLUDE [Intro - continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
+[!INCLUDE [Introduction to using a continuous file](../../../includes/cognitive-services-speech-service-how-to-recognize-intents-from-speech-continuous.md)]
 
-[!code-java[Intent Recognition Using Events From a File](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentContinuousRecognitionWithFile)]
+[!code-java[Intent recognition by using events from a file](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/IntentRecognitionSamples.java#IntentContinuousRecognitionWithFile)]
 
 [!INCLUDE [Get the samples](../../../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
 

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

@@ -6,10 +6,9 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Intent recognition from a file, using events
+## Intent recognition from a file with events
 
-The code snippet shows how to recognize intent in the default language (`en-US`) in a continuous way. This code allows access to additional information, like intermediate results. 
-Input is taken from an audio file, the supported format is single-channel (mono) WAV / PCM with a sampling rate of 16 kHz.
+The following code shows how to recognize intent in the default language (en-US) in a continuous way. The code allows access to additional information like intermediate results. Input is taken from an audio file. 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-intents-from-speech-intro.md

@@ -8,19 +8,19 @@ ms.author: wolfma
 
 <!-- N.B. no header, language-agnostic -->
 
-The [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides a way to recognize **intents from speech**, powered by the Speech service and the [Language Understanding service (LUIS)](https://www.luis.ai/home).
+The Microsoft Cognitive Services [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides a way to recognize **intents from speech** and is supported by the Cognitive Services [Language Understanding service (LUIS)](https://www.luis.ai/home).
 
-1. Create a speech factory, providing a Language Understanding service subscription key and [region](~/articles/cognitive-services/speech-service/regions.md#regions-for-intent-recognition). The Language Understanding service subscription key is called **endpoint key** in the service documentation. You can't use the Language Understanding service authoring key. See also the **Note** below.
+1. Create a speech factory with a LUIS subscription key and [region](~/articles/cognitive-services/speech-service/regions.md#regions-for-intent-recognition) as parameters. The LUIS subscription key is called **endpoint key** in the service documentation. You can't use the LUIS authoring key. (See the note later in this section.)
 
 1. Get an intent recognizer from the speech factory. A recognizer can use your device's default microphone, an audio stream, or audio from a file.
 
-1. Get the language understanding model based on your AppId, and add the intents you require. 
+1. Get the language understanding model that's based on your **AppId**. Add the intents you require. 
 
-1. Tie up the events for asynchronous operation, if desired. The recognizer then calls your event handlers when it has interim and final results (including intents). 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 (includes intents). If you don't tie up the events, your application receives only a final transcription result.
 
-1. Start intent recognition. For single-shot recognition, like command or query recognition, use `RecognizeAsync()`, which returns the first utterance being recognized. For long-running recognition use `StartContinuousRecognitionAsync()` and tie up the events for asynchronous recognition results.
+1. Start intent 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, use the `StartContinuousRecognitionAsync()` method. Tie up the events for asynchronous recognition results.
 
-See the code snippets below for intent recognition scenarios using the Speech SDK. Replace your own Language Understanding subscription key (endpoint key), the [region of your subscription](~/articles/cognitive-services/speech-service/regions.md#regions-for-intent-recognition), and the AppId of your intent model in the appropriate places in the samples.
+See the following code snippets for intent recognition scenarios that use the Speech SDK. Replace the values in the sample with your own LUIS subscription key (endpoint key), the [region of your subscription](~/articles/cognitive-services/speech-service/regions.md#regions-for-intent-recognition), and the **AppId** of your intent model.
 
 > [!NOTE]
-> In contrast to other services supported by the Speech SDK, intent recognition requires a specific subscription key (Language Understanding service endpoint key). [Here](https://www.luis.ai) you can find additional information about the intent recognition technology. How to acquire the **endpoint key** is described [here](https://docs.microsoft.com/en-us/azure/cognitive-services/LUIS/luis-how-to-azure-subscription#create-luis-endpoint-key).
+> In contrast to other services supported by the Speech SDK, intent recognition requires a specific subscription key (LUIS endpoint key). For information about the intent recognition technology, see the [LUIS website](https://www.luis.ai). For information on how to acquire the **endpoint key**, see [Create a LUIS endpoint key](https://docs.microsoft.com/azure/cognitive-services/LUIS/luis-how-to-azure-subscription#create-luis-endpoint-key).

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

@@ -6,7 +6,7 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Intent recognition using microphone in a specified language
+## Intent recognition for a specified language
 
-The code snippet below shows how to recognize intent from microphone input in a specified language, in this case in German (`de-de`).
+The following code shows how to recognize intent from microphone input in a specified language. In this example, the language is German (de-de).
 

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

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

includes/cognitive-services-speech-service-how-to-toplevel-declarations.md

@@ -8,5 +8,5 @@ ms.author: wolfma
 
 ## Top-level declarations
 
-For all code below, the following top-level declarations should be in place:
+For all code in the following sections, these top-level declarations should be in place:
 

includes/cognitive-services-speech-service-sample-audio.md

@@ -7,4 +7,4 @@ ms.author: wolfma
 ---
 
 > [!NOTE]
-> Need a sample audio? Please right-click and choose **Save target as** on this link: [whatstheweatherlike.wav](https://raw.githubusercontent.com/Azure-Samples/Cognitive-Speech-STT-Android/95b698b584bce01d7cfa7faa15fb254482b6402e/samples/SpeechRecoExample/assets/whatstheweatherlike.wav)
+> Need a sample audio? Right-click this [WAV file](https://raw.githubusercontent.com/Azure-Samples/Cognitive-Speech-STT-Android/95b698b584bce01d7cfa7faa15fb254482b6402e/samples/SpeechRecoExample/assets/whatstheweatherlike.wav) and choose **Save target as**.

includes/cognitive-services-speech-service-speech-sdk-sample-download-h2.md

@@ -8,5 +8,5 @@ ms.author: wolfma
 
 ## Get the samples
 
-For the latest set of samples, check out our [Cognitive Services Speech SDK Sample GitHub repository](https://aka.ms/csspeech/samples).
+For the latest samples, see the [Cognitive Services Speech SDK sample code repository](https://aka.ms/csspeech/samples) on GitHub.