Minor edits.

TimShererWithAquent · TimShererWithAquent · commit 6bc57e445854 · 2023-08-23T14:17:25.000-07:00
diff --git a/articles/ai-services/speech-service/includes/common/environment-variables.md b/articles/ai-services/speech-service/includes/common/environment-variables.md
@@ -7,15 +7,15 @@ ms.date: 08/24/2023
 ms.author: eur
 ---
 
-Your application must be authenticated to access Azure AI services resources. For production, use a secure way of storing and accessing your credentials. For example, after you [get a key](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource) for your <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Speech resource</a>, write it to a new environment variable on the local machine that runs the application.
+Your application must be authenticated to access Azure AI services resources. For production, use a secure way of storing and accessing your credentials. For example, after you [get a key](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource) for your Speech resource, write it to a new environment variable on the local machine that runs the application.
 
 > [!TIP]
 > Don't include the key directly in your code, and never post it publicly. See [Azure AI services security](../../../security-features.md) article for more authentication options such as [Azure Key Vault](../../../use-key-vault.md).
 
 To set the environment variable for your Speech resource key, open a console window, and follow the instructions for your operating system and development environment.
 
-- To set the `SPEECH_KEY` environment variable, replace `your-key` with one of the keys for your resource.
-- To set the `SPEECH_REGION` environment variable, replace `your-region` with one of the regions for your resource.
+- To set the `SPEECH_KEY` environment variable, replace *your-key* with one of the keys for your resource.
+- To set the `SPEECH_REGION` environment variable, replace *your-region* with one of the regions for your resource.
 
 #### [Windows](#tab/windows)
 
@@ -25,9 +25,9 @@ setx SPEECH_REGION your-region
 ```
 
 > [!NOTE]
-> If you only need to access the environment variable in the current running console, you can set the environment variable with `set` instead of `setx`.
+> If you only need to access the environment variables in the current console, you can set the environment variable with `set` instead of `setx`.
 
-After you add the environment variables, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variables, you might need to restart any programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before you run the example.
 
 #### [Linux](#tab/linux)
 
@@ -42,7 +42,7 @@ After you add the environment variables, run `source ~/.bashrc` from your consol
 
 ##### Bash
 
-Edit your *.bash_profile*, and add the environment variables:
+Edit your *.bash_profile* file, and add the environment variables:
 
 ```bash
 export SPEECH_KEY=your-key
@@ -62,5 +62,5 @@ For iOS and macOS development, you set the environment variables in Xcode. For e
 
 To set the environment variable for your Speech resource region, follow the same steps. Set `SPEECH_REGION` to the region of your resource. For example, `westus`.
 
-For more configuration options, see the [Xcode documentation](https://help.apple.com/xcode/#/dev745c5c974).
+For more configuration options, see [Configuration Settings File (xcconfig) format](https://help.apple.com/xcode/#/dev745c5c974).
 ***
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cli.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cli.md
@@ -24,7 +24,7 @@ ms.author: eur
    spx recognize --microphone --source en-US
    ```
 
-1. 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, 30 seconds, or when you press Ctrl+C.
+1. 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, 30 seconds, or when you select **Ctrl**+**C**.
 
    ```output
    Connection CONNECTED...
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cpp.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cpp.md
@@ -16,15 +16,15 @@ ms.author: eur
 
 ## Set up the environment
 
-The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) and implements .NET Standard 2.0. You install the Speech SDK later in this guide. For any other requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp).
+The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) and implements .NET Standard 2.0. You install the Speech SDK later in this guide. For other requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
 ## Recognize speech from a microphone
 
-Follow these steps to create a new console application and install the Speech SDK.
+Follow these steps to create a console application and install the Speech SDK.
 
 1. Create a new C++ console project in Visual Studio Community 2022 named `SpeechRecognition`.
 1. Install the Speech SDK in your new project with the NuGet package manager.
@@ -114,7 +114,7 @@ Follow these steps to create a new console application and install the Speech SD
    > [!IMPORTANT]
    > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described in [Set environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-1. Speak into your microphone when prompted. What you speak should be output as text:
+1. Speak into your microphone when prompted. What you speak should appear as text:
 
    ```output
    Speak into your microphone.
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/csharp.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/csharp.md
@@ -24,7 +24,7 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 ## Recognize speech from a microphone
 
-Follow these steps to create a new console application and install the Speech SDK.
+Follow these steps to create a console application and install the Speech SDK.
 
 1. Open a command prompt where you want the new project. Create a console application with the .NET CLI, which creates the *Program.cs* file in the project directory.
 
@@ -103,7 +103,7 @@ Follow these steps to create a new console application and install the Speech SD
    > [!IMPORTANT]
    > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described in [Set environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-1. Speak into your microphone when prompted. What you speak should be output as text: 
+1. Speak into your microphone when prompted. What you speak should appear as text:
 
    ```output
    Speak into your microphone.
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/go.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/go.md
@@ -24,7 +24,7 @@ Install the [Speech SDK for Go](../../../quickstarts/setup-platform.md?pivots=pr
 
 ## Recognize speech from a microphone
 
-Follow these steps to create a new GO module.
+Follow these steps to create a GO module.
 
 1. Open a command prompt where you want the new module, and create a new file named *speech-recognition.go*.
 1. Copy the following code into *speech-recognition.go*:
@@ -111,7 +111,7 @@ Follow these steps to create a new GO module.
    > [!IMPORTANT]
    > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described in [Set environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-1. Now build and run the code:
+1. Build and run the code:
 
    ```cmd
    go build
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/java.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/java.md
@@ -19,7 +19,7 @@ ms.author: eur
 Before you can do anything, you need to install the Speech SDK. The sample in this quickstart works with the [Java Runtime](~/articles/ai-services/speech-service/quickstarts/setup-platform.md?pivots=programming-language-java&tabs=jre).
 
 1. Install [Apache Maven](https://maven.apache.org/install.html). Then run `mvn -v` to confirm successful installation.
-1. Create a new `pom.xml` file in the root of your project, and copy the following into it:
+1. Create a new `pom.xml` file in the root of your project, and copy the following code into it:
 
    ```xml
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
@@ -62,7 +62,7 @@ Before you can do anything, you need to install the Speech SDK. The sample in th
 
 ## Recognize speech from a microphone
 
-Follow these steps to create a new console application for speech recognition.
+Follow these steps to create a console application for speech recognition.
 
 1. Create a new file named *SpeechRecognition.java* in the same project root directory.
 1. Copy the following code into *SpeechRecognition.java*:
@@ -117,7 +117,7 @@ Follow these steps to create a new console application for speech recognition.
 
 1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, `es-ES` for Spanish (Spain). If you don't specify a language, the default is `en-US`. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md).
 
-   Run your new console application to start speech recognition from a microphone:
+1. Run your new console application to start speech recognition from a microphone:
 
    ```console
    javac SpeechRecognition.java -cp ".;target\dependency\*"
@@ -127,9 +127,9 @@ Follow these steps to create a new console application for speech recognition.
    > [!IMPORTANT]
    > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described in [Set environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-1. Speak into your microphone when prompted. What you speak should be output as text: 
+1. Speak into your microphone when prompted. What you speak should appear as text:
 
-   ```console
+   ```output
    Speak into your microphone.
    RECOGNIZED: Text=I'm excited to try speech to text.
    ```
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/javascript.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/javascript.md
@@ -18,7 +18,7 @@ You also need a *.wav* audio file on your local machine. You can use your own *.
 
 ## Set up the environment
 
-Before you can do anything, you need to install the Speech SDK for JavaScript. If you just want the package name to install, run `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see the [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
+Before you can do anything, you need to install the Speech SDK for JavaScript. Run this command: `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see the [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
 
 ### Set environment variables
 
@@ -88,7 +88,7 @@ Follow these steps to create a Node.js console application for speech recognitio
 
    The speech from the audio file should be output as text:
 
-   ```console
+   ```output
    RECOGNIZED: Text=I'm excited to try speech to text.
    ```
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/objectivec.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/objectivec.md
@@ -29,8 +29,8 @@ The Speech SDK can be used in Xcode projects as a [CocoaPod](https://cocoapods.o
 Follow these steps to recognize speech in a macOS application.
 
 1. Clone the [Azure-Samples/cognitive-services-speech-sdk](https://github.com/Azure-Samples/cognitive-services-speech-sdk) repository to get the [Recognize speech from a microphone in Objective-C on macOS](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/macos/from-microphone) sample project. The repository also has iOS samples.
-1. Navigate to the directory of the downloaded sample app (`helloworld`) in a terminal. 
-1. Run the command `pod install`. This command generates a `helloworld.xcworkspace` Xcode workspace containing both the sample app and the Speech SDK as a dependency. 
+1. In a console window, navigate to the directory of the downloaded sample app, *helloworld*.
+1. Run the command `pod install`. This command generates a `helloworld.xcworkspace` Xcode workspace that contains both the sample app and the Speech SDK as a dependency.
 1. Open the `helloworld.xcworkspace` workspace in Xcode.
 1. Open the file named *AppDelegate.m* and locate the `buttonPressed` method as shown here.
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/python.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/python.md
@@ -18,18 +18,18 @@ ms.author: eur
 
 The Speech SDK for Python is available as a [Python Package Index (PyPI) module](https://pypi.org/project/azure-cognitiveservices-speech/). The Speech SDK for Python is compatible with Windows, Linux, and macOS.
 
-- You must install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022](/cpp/windows/latest-supported-vc-redist?view=msvc-170&preserve-view=true) for your platform. Installing this package for the first time might require a restart.
+- For Windows, install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022](/cpp/windows/latest-supported-vc-redist?view=msvc-170&preserve-view=true) for your platform. Installing this package for the first time might require a restart.
 - On Linux, you must use the x64 target architecture.
 
-Install a version of [Python from 3.7 or later](https://www.python.org/downloads/). For any other requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-python).
+Install a version of [Python from 3.7 or later](https://www.python.org/downloads/). For other requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-python).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
 ## Recognize speech from a microphone
 
-Follow these steps to create a new console application.
+Follow these steps to create a console application.
 
 1. Open a command prompt where you want the new project, and create a new file named *speech_recognition.py*.
 1. Run this command to install the Speech SDK:  
@@ -80,9 +80,9 @@ Follow these steps to create a new console application.
    > [!IMPORTANT]
    > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described in [Set environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-1. Speak into your microphone when prompted. What you speak should be output as text:
+1. Speak into your microphone when prompted. What you speak should appear as text:
 
-   ```console
+   ```output
    Speak into your microphone.
    RECOGNIZED: Text=I'm excited to try speech to text.
    ```
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/rest.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/rest.md
@@ -14,15 +14,15 @@ ms.author: eur
 
 [!INCLUDE [Prerequisites](../../common/azure-prerequisites.md)]
 
-You also need a *.wav* audio file on your local machine. You can use your own *.wav* file (up to 60 seconds) or download the [https://crbn.us/whatstheweatherlike.wav](https://crbn.us/whatstheweatherlike.wav) sample file.
+You also need a *.wav* audio file on your local machine. You can use your own *.wav* file up to 60 seconds or download the [https://crbn.us/whatstheweatherlike.wav](https://crbn.us/whatstheweatherlike.wav) sample file.
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
 ## Recognize speech from a file
 
-At a command prompt, run the following cURL command. Replace *YourAudioFile.wav* with the path and name of your audio file.  
+Open a console window and run the following cURL command. Replace *YourAudioFile.wav* with the path and name of your audio file.  
 
 # [Windows](#tab/windows)
 
diff --git a/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/swift.md b/articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/swift.md
@@ -136,7 +136,6 @@ After you select the button in the app and say a few words, you should see the t
 
 ## Remarks
 
-
 This example uses the `recognizeOnce` operation to transcribe utterances of up to 30 seconds, or until silence is detected. For information about continuous recognition for longer audio, including multi-lingual conversations, see [How to recognize speech](~/articles/ai-services/speech-service/how-to-recognize-speech.md).
 
 ## Clean up resources
diff --git a/articles/ai-services/speech-service/includes/spx-setup-quick.md b/articles/ai-services/speech-service/includes/spx-setup-quick.md
@@ -10,13 +10,13 @@ ms.custom: ignite-fall-2021
 
 Follow these steps and see the [Speech CLI quickstart](~/articles/ai-services/speech-service/spx-basics.md#download-and-install) for other requirements for your platform.
 
-1. Install the Speech CLI via the .NET CLI by entering this command:
+1. Run the following .NET CLI command to install the Speech CLI:
 
    ```dotnetcli
    dotnet tool install --global Microsoft.CognitiveServices.Speech.CLI
    ```
 
-1. Configure your Speech resource key and region by running the following commands. Replace `SUBSCRIPTION-KEY` with your Speech resource key, and replace `REGION` with your Speech resource region:
+1. Run the following commands to configure your Speech resource key and region. Replace `SUBSCRIPTION-KEY` with your Speech resource key and replace `REGION` with your Speech resource region.
 
    # [Terminal](#tab/terminal)
 
