Merge pull request #249061 from TimShererWithAquent/us141588d

Azure OpenAI Freshness Pass - User Story: 141588

Author: v-regandowner

articles/ai-services/speech-service/get-started-speech-to-text.md

@@ -1,14 +1,14 @@
 ---
 title: "Speech to text quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, you convert speech to text with recognition from a microphone.
+description: In this quickstart, learn how to convert speech to text with recognition from a microphone or .wav file.
 services: cognitive-services
 author: eric-urban
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: quickstart
-ms.date: 09/16/2022
+ms.date: 08/24/2023
 ms.author: eur
 ms.devlang: cpp, csharp, golang, java, javascript, objective-c, python
 ms.custom: devx-track-python, devx-track-js, devx-track-csharp, cog-serv-seo-aug-2020, mode-other, devx-track-extended-java, devx-track-go

articles/ai-services/speech-service/includes/common/azure-prerequisites.md

@@ -2,12 +2,12 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
-ms.date: 06/30/2022
+ms.date: 08/24/2023
 ms.topic: include
 ms.author: eur
 ---
 
 > [!div class="checklist"]
-> * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-> * <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Create a Speech resource</a> in the Azure portal.
-> * Get the Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. For more information about Azure AI services resources, see [Get the keys for your resource](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource). 
+> - Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services).
+> - <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Create a Speech resource</a> in the Azure portal.
+> - Your Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. For more information about Azure AI services resources, see [Get the keys for your resource](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource). 

articles/ai-services/speech-service/includes/common/delete-resource.md

@@ -3,7 +3,7 @@ author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 01/25/2022
+ms.date: 08/24/2023
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/common/environment-variables.md

@@ -3,18 +3,19 @@ author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 09/14/2022
+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 running 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 the Azure AI services [security](../../../security-features.md) article for more authentication options like [Azure Key Vault](../../../use-key-vault.md). 
+> Don't include the key directly in your code, and never post it publicly. See [Azure AI services security](../../../security-features.md) 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 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.
 
 #### [Windows](#tab/windows)
 
@@ -24,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 may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you are 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)
 
@@ -41,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
@@ -54,12 +55,12 @@ After you add the environment variables, run `source ~/.bash_profile` from your
 
 For iOS and macOS development, you set the environment variables in Xcode. For example, follow these steps to set the environment variable in Xcode 13.4.1.
 
-1. Select **Product** > **Scheme** > **Edit scheme**
-1. Select **Arguments** on the **Run** (Debug Run) page
-1. Under **Environment Variables** select the plus (+) sign to add a new environment variable. 
+1. Select **Product** > **Scheme** > **Edit scheme**.
+1. Select **Arguments** on the **Run** (Debug Run) page.
+1. Under **Environment Variables** select the plus (+) sign to add a new environment variable.
 1. Enter `SPEECH_KEY` for the **Name** and enter your Speech resource key for the **Value**.
 
 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 [the Xcode documentation](https://help.apple.com/xcode/#/dev745c5c974).
 ***

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cli.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 02/12/2022
+ms.date: 08/24/2023
 ms.author: eur
 ---
 
@@ -18,59 +18,77 @@ ms.author: eur
 
 ## Recognize speech from a microphone
 
-Run the following command to start speech recognition from a microphone:
+1. Run the following command to start speech recognition from a microphone:
 
-```console
-spx recognize --microphone --source en-US
-```
+   ```console
+   spx recognize --microphone --source en-US
+   ```
 
-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**.
 
-```console
-Connection CONNECTED...
-RECOGNIZED: I'm excited to try speech to text.
-```
+   ```output
+   Connection CONNECTED...
+   RECOGNIZED: I'm excited to try speech to text.
+   ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
+
+Here are some other considerations:
 
 - To recognize speech from an audio file, use `--file` instead of `--microphone`. For compressed audio files such as MP4, install GStreamer and use `--format`. For more information, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md).
+
     # [Terminal](#tab/terminal)
+
     ```console
     spx recognize --file YourAudioFile.wav
     spx recognize --file YourAudioFile.mp4 --format any
     ```
+
     # [PowerShell](#tab/powershell)
+
     ```powershell
     spx recognize --file YourAudioFile.wav
     spx --% recognize --file YourAudioFile.mp4 --format any
     ```
+
     ***
+
 - To improve recognition accuracy of specific words or utterances, use a [phrase list](~/articles/ai-services/speech-service/improve-accuracy-phrase-list.md). You include a phrase list in-line or with a text file along with the recognize command:
+
     # [Terminal](#tab/terminal)
+
     ```console
     spx recognize --microphone --phrases "Contoso;Jessie;Rehaan;"
     spx recognize --microphone --phrases @phrases.txt
     ```
+
     # [PowerShell](#tab/powershell)
+
     ```powershell
     spx --% recognize --microphone --phrases "Contoso;Jessie;Rehaan;"
     spx --% recognize --microphone --phrases @phrases.txt
+
     ```
+
     ***
-- 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). The default language is `en-US` if you don't specify a language.
+
+- To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, use `es-ES` for Spanish (Spain). If you don't specify a language, the default is `en-US`.
+
     ```console
     spx recognize --microphone --source es-ES
     ```
+
 - For continuous recognition of audio longer than 30 seconds, append `--continuous`:
+
     ```console
     spx recognize --microphone --source es-ES --continuous
     ```
 
-Run this command for information about additional speech recognition options such as file input and output:
-```console
-spx help recognize
-```
+- Run this command for information about more speech recognition options such as file input and output:
+
+    ```console
+    spx help recognize
+    ```
 
 ## Clean up resources