Merge pull request #50150 from GitHubber17/1320921-translate-speech

edit pass: cognitive services translate speech

Author: ShawnJackson

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

@@ -12,24 +12,24 @@ ms.date: 07/16/2018
 ms.author: wolfma
 ---
 
-# Translate speech by using the Speech SDK for C++
+# Translate speech with the Cognitive Services Speech SDK for C++
 
 [!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-translate-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
 
-[!INCLUDE [Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!INCLUDE [Introduction to 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/translation_samples.cpp#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
 
-[!code-cpp[Translation Using Microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/translation_samples.cpp#TranslationWithMicrophone)]
+[!code-cpp[Translation using a microphone](~/samples-cognitive-services-speech-sdk/samples/cpp/windows/console/samples/translation_samples.cpp#TranslationWithMicrophone)]
 
 [!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
 
 - [How to recognize speech](how-to-recognize-speech-cpp.md)
-- [How to recognize intents from speech](how-to-recognize-intents-from-speech-cpp.md).
+- [How to recognize intents from speech](how-to-recognize-intents-from-speech-cpp.md)

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

@@ -12,28 +12,28 @@ ms.date: 07/16/2018
 ms.author: wolfma
 ---
 
-# Translate speech by using the Speech SDK for C#
+# Translate speech with the Cognitive Services Speech SDK for C#
 
 [!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-translate-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
 
-[!INCLUDE [Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!INCLUDE [Introduction to 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/translation_samples.cs#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
 
-[!code-csharp[Translation Using Microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/translation_samples.cs#TranslationWithMicrophoneAsync)]
+[!code-csharp[Translation from a microphone](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/translation_samples.cs#TranslationWithMicrophoneAsync)]
 
-[!INCLUDE [Intro - using file](../../../includes/cognitive-services-speech-service-how-to-translate-speech-file.md)]
+[!INCLUDE [Introduction to using a file](../../../includes/cognitive-services-speech-service-how-to-translate-speech-file.md)]
 
-[!code-csharp[Translation Using File Input](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/translation_samples.cs#TranslationWithFileAsync)]
+[!code-csharp[Translation from file input](~/samples-cognitive-services-speech-sdk/samples/csharp/sharedcontent/console/translation_samples.cs#TranslationWithFileAsync)]
 
 [!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
 
 - [How to recognize speech](how-to-recognize-speech-csharp.md)
-- [How to recognize intents from speech](how-to-recognize-intents-from-speech-csharp.md).
+- [How to recognize intents from speech](how-to-recognize-intents-from-speech-csharp.md)

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

@@ -12,27 +12,28 @@ ms.date: 07/16/2018
 ms.author: wolfma
 ---
 
-# Translate speech using the Speech SDK for Java
+# Translate speech with the Cognitive Services Speech SDK for Java
 
 [!INCLUDE [Selector](../../../includes/cognitive-services-speech-service-how-to-translate-speech-selector.md)]
 
-[!INCLUDE [Intro](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
+[!INCLUDE [Introduction](../../../includes/cognitive-services-speech-service-how-to-translate-speech-intro.md)]
 
-[!INCLUDE [Intro - top-level declarations](../../../includes/cognitive-services-speech-service-how-to-toplevel-declarations.md)]
+[!INCLUDE [Introduction to 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/TranslationSamples.java#toplevel)]
 
-[!INCLUDE [Intro - using microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
+[!INCLUDE [Introduction to using a microphone](../../../includes/cognitive-services-speech-service-how-to-translate-speech-microphone.md)]
 
-[!code-java [Translation Using Microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/TranslationSamples.java#TranslationWithMicrophoneAsync)]
+[!code-java [Translation from a microphone](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/TranslationSamples.java#TranslationWithMicrophoneAsync)]
 
-[!INCLUDE [Intro - using file](../../../includes/cognitive-services-speech-service-how-to-translate-speech-file.md)]
+[!INCLUDE [Introduction to using a file](../../../includes/cognitive-services-speech-service-how-to-translate-speech-file.md)]
 
-[!code-java [Translation Using File Input](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/TranslationSamples.java#TranslationWithFileAsync)]
+[!code-java [Translation from file input](~/samples-cognitive-services-speech-sdk/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/TranslationSamples.java#TranslationWithFileAsync)]
 
 [!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
 
 - [How to recognize speech](how-to-recognize-speech-java.md)
-- [How to recognize intents from speech](how-to-recognize-intents-from-speech-java.md).
+- [How to recognize intents from speech](how-to-recognize-intents-from-speech-java.md)

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

@@ -7,4 +7,4 @@ ms.author: wolfma
 ---
 
 > [!NOTE]
-> First, obtain a subscription key. For more information, see [Try the Speech service for free](~/articles/cognitive-services/speech-service/get-started.md).
+> First, get 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-translate-speech-file.md

@@ -6,7 +6,6 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Translation using file input
+## Translation from file input
 
-The code snippet below shows how to translate speech input from English to German and French.
-It uses a file as input.
+The following code snippet shows you how to translate speech input from English to German and French. The code uses a file as input.

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

@@ -8,17 +8,17 @@ ms.author: wolfma
 
 <!-- N.B. no header, language-agnostic -->
 
-The [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides the simplest way to use **speech translation** in your application.
+The Microsoft Cognitive Services [Speech SDK](~/articles/cognitive-services/speech-service/speech-sdk.md) provides the simplest way to use **speech translation** in your application.
 The SDK provides the full functionality of the service. The basic process for performing speech translation includes the following steps:
 
-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).
+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.
 
-1. Create a translation recognizer from the speech factory. You can configure the source and target translation languages, as well as specifying whether you want text or speech output. There are various flavors of translation recognizers based on the audio source you are using.
+1. Create a translation recognizer from the speech factory. You can configure the source and target translation languages, as well as specify whether you want text or speech output. There are various flavors of translation recognizers based on the audio source that you use.
 
-1. Tie up the events for asynchronous operation, if desired. The recognizer then calls your event handlers when it has interim and final results, as well as a synthesis event for the optional audio output. 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, as well as a synthesis event for the optional audio output. Otherwise, your application receives only a final transcription result.
 
-1. Start recognition. For single-shot translation use RecognizeAsync(), which returns the first utterance being recognized. For long-running translations, use StartContinuousRecognitionAsync() and tie up the events for asynchronous recognition results.
+1. Start recognition. For single-shot translation use the `RecognizeAsync()` method, which returns the first recognized utterance. For long-running translations, use the `StartContinuousRecognitionAsync()` method and tie up the events for asynchronous recognition results.
 
-See the code snippets below for speech translation scenarios using the Speech SDK.
+See the following code snippets for speech translation 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-translate-speech-microphone.md

@@ -6,8 +6,7 @@ ms.date: 07/27/2018
 ms.author: wolfma
 ---
 
-## Translation using the microphone
+## Translation from the microphone
 
-The code snippet below shows how to translate speech input from English to German, and also get the voice output of the translated text.
-It uses the microphone.
+The following code snippet shows you how to translate speech input from English to German and gets the voice output of the translated text. The code uses the microphone.