Merge pull request #264509 from TimShererWithAquent/us200722c

Freshness update: Azure AI Speech service

Author: v-regandowner

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

@@ -1,18 +1,19 @@
 ---
 title: "Speech to text quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, learn how to convert speech to text with recognition from a microphone or .wav file.
+description: In this quickstart, learn how to use the Speech service to convert speech to text with recognition from a microphone or .wav file.
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: quickstart
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ms.devlang: cpp
 # 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
 zone_pivot_groups: programming-languages-speech-services
 keywords: speech to text, speech to text software
+#customer intent: As a developer, I want to use Speech services to covert speech to text, from either a microphone or a file using my choice of technology.
 ---
 
 # Quickstart: Recognize and convert speech to text
@@ -57,7 +58,7 @@ keywords: speech to text, speech to text software
 [!INCLUDE [CLI include](includes/quickstarts/speech-to-text-basics/cli.md)]
 ::: zone-end
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Learn more about speech recognition](how-to-recognize-speech.md)

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -53,7 +53,7 @@ Here are some other considerations:
 
     ***
 
-- 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:
+- 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)
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -27,11 +27,12 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 Follow these steps to create a console application and install the Speech SDK.
 
 1. Create a new C++ console project in [Visual Studio Community](https://visualstudio.microsoft.com/downloads/) named `SpeechRecognition`.
-1. Install the Speech SDK in your new project with the NuGet package manager.
 
-   ```powershell
-   Install-Package Microsoft.CognitiveServices.Speech
-   ```
+1. Select **Tools** > **Nuget Package Manager** > **Package Manager Console**. In the **Package Manager Console**, run this command:
+
+    ```console
+    Install-Package Microsoft.CognitiveServices.Speech
+    ```
 
 1. Replace the contents of `SpeechRecognition.cpp` with the following code:
 
@@ -112,7 +113,7 @@ Follow these steps to create a console application and install the Speech SDK.
 1. [Build and run](/cpp/build/vscpp-step-2-build) your new console application to start speech recognition from a microphone.
 
    > [!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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [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 appear as text:
 
@@ -129,7 +130,7 @@ Here are some other considerations:
 - To recognize speech from an audio file, use `FromWavFileInput` instead of `FromDefaultMicrophoneInput`:
 
   ```cpp
-  auto audioInput = AudioConfig::FromWavFileInput("YourAudioFile.wav");
+  auto audioConfig = AudioConfig::FromWavFileInput("YourAudioFile.wav");
   ```
 
 - For compressed audio files such as MP4, install GStreamer and use `PullAudioInputStream` or `PushAudioInputStream`. For more information, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md).

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -26,12 +26,14 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 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.
+1. Open a command prompt window in the folder where you want the new project. Run this command to create a console application with the .NET CLI.
 
    ```dotnetcli
    dotnet new console
    ```
 
+   This command creates the *Program.cs* file in your project directory.
+
 1. Install the Speech SDK in your new project with the .NET CLI.
 
    ```dotnetcli
@@ -101,7 +103,7 @@ Follow these steps to create a console application and install the Speech SDK.
    ```
 
    > [!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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [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 appear as text:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -26,7 +26,8 @@ Install the Speech SDK for Go. For requirements and instructions, see [Install t
 
 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. Open a command prompt window in the folder where you want the new project. Create a new file named  *speech-recognition.go*.
+
 1. Copy the following code into *speech-recognition.go*:
 
    ```go
@@ -109,7 +110,7 @@ Follow these steps to create a 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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 1. Build and run the code:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -16,7 +16,7 @@ ms.author: eur
 
 ## Set up the environment
 
-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).
+To set up your environment, [install the Speech SDK](~/articles/ai-services/speech-service/quickstarts/setup-platform.md?pivots=programming-language-java&tabs=jre). 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 code into it:
@@ -125,7 +125,7 @@ Follow these steps to create a 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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [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 appear as text:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -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. Run this command: `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
+To set up your environment, install the Speech SDK for JavaScript. Run this command: `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
 
 ### Set environment variables
 
@@ -28,7 +28,7 @@ Before you can do anything, you need to install the Speech SDK for JavaScript. R
 
 Follow these steps to create a Node.js console application for speech recognition.
 
-1. Open a command prompt where you want the new project, and create a new file named *SpeechRecognition.js*.
+1. Open a command prompt window where you want the new project, and create a new file named *SpeechRecognition.js*.
 1. Install the Speech SDK for JavaScript:
 
    ```console
@@ -75,6 +75,7 @@ Follow these steps to create a Node.js console application for speech recognitio
    ```
 
 1. In *SpeechRecognition.js*, replace *YourAudioFile.wav* with your own *.wav* file. This example only recognizes speech from a *.wav* file. For information about other audio formats, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md). This example supports up to 30 seconds of audio.
+
 1. 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`. 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).
 
 1. Run your new console application to start speech recognition from a file:
@@ -84,7 +85,7 @@ Follow these steps to create a Node.js console application for speech recognitio
    ```
 
    > [!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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
    The speech from the audio file should be output as text:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -72,12 +72,12 @@ Follow these steps to recognize speech in a macOS application.
 
 1. 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`. 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).
 1. To make the debug output visible, select **View** > **Debug Area** > **Activate Console**.
-1. Build and run the example code by selecting **Product** > **Run** from the menu or selecting the **Play** button.
+1. To build and run the example code, select **Product** > **Run** from the menu or select the **Play** button.
 
   > [!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.
+  > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
-After you select the button in the app and say a few words, you should see the text you have spoken on the lower part of the screen. When you run the app for the first time, you should be prompted to give the app access to your computer's microphone.
+After you select the button in the app and say a few words, you should see the text that you spoke on the lower part of the screen. When you run the app for the first time, it prompts you to give the app access to your computer's microphone.
 
 ## Remarks
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -31,7 +31,8 @@ Install a version of [Python from 3.7 or later](https://www.python.org/downloads
 
 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. Open a command prompt window in the folder where you want the new project. Create a new file named *speech_recognition.py*.
+
 1. Run this command to install the Speech SDK:  
 
    ```console
@@ -78,7 +79,7 @@ Follow these steps to create a 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.
+   > Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [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 appear as text:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/24/2023
+ms.date: 01/30/2024
 ms.author: eur
 ---
 
@@ -60,7 +60,7 @@ curl --location --request POST \
 * * *
 
 > [!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.
+> Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 You should receive a response similar to what is shown here. The `DisplayText` should be the text that was recognized from your audio file. The command recognizes up to 60 seconds of audio and converts it to text.