Merge pull request #186896 from ShawnJackson/get-started-speech-to-text

edit pass: get-started-speech-to-text

Author: Ja-Dunn

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

@@ -1,7 +1,7 @@
 ---
 title: "Speech-to-text quickstart - Speech service"
 titleSuffix: Azure Cognitive Services
-description: Learn how to use the Speech SDK to convert speech-to-text. In this quickstart, you learn about object construction, supported audio input formats, and configuration options for speech recognition.
+description: Learn how to use the Speech SDK to convert speech to text, including object construction, supported audio input formats, and configuration options for speech recognition.
 services: cognitive-services
 author: eric-urban
 manager: nitinme

articles/cognitive-services/Speech-Service/includes/how-to/speech-to-text-basics/speech-to-text-basics-browser-js.md

@@ -7,10 +7,10 @@ ms.author: eur
 ms.custom: devx-track-js
 ---
 
-One of the core features of the Speech service is the ability to recognize and transcribe human speech (often referred to as speech-to-text). In this sample, you learn how to use the Speech SDK in your apps and products to perform high-quality speech-to-text conversion.
+One of the core features of the Speech service is the ability to recognize and transcribe human speech (often called speech-to-text). In this sample, you learn how to use the Speech SDK in your apps and products to perform high-quality speech-to-text conversion.
 
 ## React sample on GitHub
 
-Go to the [React sample](https://github.com/Azure-Samples/AzureSpeechReactSample) on GitHub to learn how to use the Speech SDK in a browser-based JavaScript environment. This sample shows design pattern examples for authentication token exchange and management, and capturing audio from a microphone or file for speech-to-text conversions.
+Go to the [React sample](https://github.com/Azure-Samples/AzureSpeechReactSample) on GitHub to learn how to use the Speech SDK in a browser-based JavaScript environment. This sample shows design patterns for the exchange and management of authentication tokens. It also shows the capture of audio from a microphone or file for speech-to-text conversions.
 
-Additionally, the design patterns used in the [Node.js quickstart](../../../get-started-speech-to-text.md?pivots=programming-language-nodejs&tabs=script%2cbrowser%2cwindowsinstall) can also be used in a browser environment.
+You can also use the design patterns in the [Node.js quickstart](../../../get-started-speech-to-text.md?pivots=programming-language-nodejs&tabs=script%2cbrowser%2cwindowsinstall) in a browser environment.

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

@@ -6,38 +6,36 @@ ms.date: 09/08/2020
 ms.author: eur
 ---
 
-One of the core features of the Speech service is the ability to recognize and transcribe human speech (often referred to as speech-to-text). In this quickstart, you learn how to use the Speech CLI in your apps and products to perform high-quality speech-to-text conversion.
+One of the core features of the Speech service is the ability to recognize and transcribe human speech (often called speech-to-text). In this quickstart, you learn how to use the Speech CLI in your apps and products to perform high-quality speech-to-text conversion.
 
 [!INCLUDE [SPX Setup](../../spx-setup.md)]
 
-## Speech-to-text from microphone
+## Speech-to-text from a microphone
 
-Plug in and turn on your PC microphone, and turn off any apps that might also use the microphone. Some computers have a built-in microphone, while others require configuration of a Bluetooth device.
+Plug in and turn on your PC microphone. Turn off any apps that might also use the microphone. Some computers have a built-in microphone, whereas others require configuration of a Bluetooth device.
 
-Now you're ready to run the Speech CLI to recognize speech from your microphone. From the command line, change to the directory that contains the Speech CLI binary file, and run the following command.
+Now you're ready to run the Speech CLI to recognize speech from your microphone. From the command line, change to the directory that contains the Speech CLI binary file. Then run the following command:
 
 ```bash
 spx recognize --microphone
 ```
 
 > [!NOTE]
-> The Speech CLI defaults to English. You can choose a different language [from the Speech-to-text table](../../../../language-support.md).
-> For example, add `--source de-DE` to recognize German speech.
+> The Speech CLI defaults to English. You can choose a different language [from the speech-to-text table](../../../../language-support.md). For example, add `--source de-DE` to recognize German speech.
 
-Speak into the microphone, and you see transcription of your words into text in real-time. The Speech CLI will stop after a period of silence, or when you press ctrl-C.
+Speak into the microphone, and you see transcription of your words into text in real time. The Speech CLI stops after a period of silence, or when you select Ctrl+C.
 
-## Speech-to-text from audio file
+## Speech-to-text from an audio file
 
-The Speech CLI can recognize speech in many file formats and natural languages. In this example, you can use any WAV file (16kHz or 8kHz, 16-bit, and mono PCM) that contains English speech. Or if you want a quick sample, download the <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/csharp/sharedcontent/console/whatstheweatherlike.wav" download="whatstheweatherlike" target="_blank">whatstheweatherlike.wav <span class="docon docon-download x-hidden-focus"></span></a> file and copy it to the same directory as the Speech CLI binary file.
+The Speech CLI can recognize speech in many file formats and natural languages. In this example, you can use any WAV file (16 KHz or 8 KHz, 16-bit, and mono PCM) that contains English speech. Or if you want a quick sample, download the <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/csharp/sharedcontent/console/whatstheweatherlike.wav" download="whatstheweatherlike" target="_blank">whatstheweatherlike.wav <span class="docon docon-download x-hidden-focus"></span></a> file and copy it to the same directory as the Speech CLI binary file.
 
-Now you're ready to run the Speech CLI to recognize speech found in the audio file by running the following command.
+Use the following command to run the Speech CLI to recognize speech found in the audio file:
 
 ```bash
 spx recognize --file whatstheweatherlike.wav
 ```
 
 > [!NOTE]
-> The Speech CLI defaults to English. You can choose a different language [from the Speech-to-text table](../../../../language-support.md).
-> For example, add `--source de-DE` to recognize German speech.
+> The Speech CLI defaults to English. You can choose a different language [from the speech-to-text table](../../../../language-support.md). For example, add `--source de-DE` to recognize German speech.
 
-The Speech CLI will show a text transcription of the speech on the screen.
+The Speech CLI shows a text transcription of the speech on the screen.