Merge pull request #264372 from TimShererWithAquent/us200722b

Freshness update: Azure AI Speech service

Author: prmerger-automator[bot]

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

@@ -1,18 +1,19 @@
 ---
 title: "Text to speech quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, you convert text to speech. Learn about object construction and design patterns, supported audio formats, and custom configuration options.
+description: In this quickstart, you create an app that converts text to speech. Learn about supported audio formats and custom configuration options.
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: quickstart
-ms.date: 08/25/2023
+ms.date: 01/29/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: text to speech
+#customer intent: As a user, I want to create speech output from text by using my choice of technologies which fit into my current processes.
 ---
 
 # Quickstart: Convert text to speech
@@ -57,7 +58,7 @@ keywords: text to speech
 [!INCLUDE [CLI include](includes/quickstarts/text-to-speech-basics/cli.md)]
 ::: zone-end
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Learn more about speech synthesis](how-to-speech-synthesis.md)

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -24,14 +24,9 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 ## Synthesize to speaker output
 
-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 C++ console project in [Visual Studio Community](https://visualstudio.microsoft.com/downloads/) named `SpeechSynthesis`.
-1. Install the Speech SDK in your new project with the NuGet package manager.
-
-   ```powershell
-   Install-Package Microsoft.CognitiveServices.Speech
-   ```
 
 1. Replace the contents of *SpeechSynthesis.cpp* with the following code:
 
@@ -111,14 +106,20 @@ Follow these steps to create a new console application and install the Speech SD
     }  
     ```
 
+1. Select **Tools** > **Nuget Package Manager** > **Package Manager Console**. In the **Package Manager Console**, run this command:
+
+    ```console
+    Install-Package Microsoft.CognitiveServices.Speech
+    ```
+
 1. To change the speech synthesis language, replace `en-US-JennyNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
    All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 1. [Build and run your new console application](/cpp/build/vscpp-step-2-build) to start speech synthesis to the default speaker.
 
    > [!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. Enter some text that you want to speak. For example, type *I'm excited to try text to speech*. Select the **Enter** key to hear the synthesized speech.
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -24,14 +24,16 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 ## Synthesize to speaker output
 
-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. Run this command to create a console application with the .NET CLI. The command creates a *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
    ```
 
+   The command creates a *Program.cs* file in the project directory.
+
 1. Install the Speech SDK in your new project with the .NET CLI.
 
    ```dotnetcli
@@ -110,7 +112,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.
+   > 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. Enter some text that you want to speak. For example, type *I'm excited to try text to speech*. Select the **Enter** key to hear the synthesized speech.
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -24,9 +24,9 @@ Install the Speech SDK for Go. For requirements and instructions, see [Install t
 
 ## Synthesize to speaker output
 
-Follow these steps to create a new Go module.
+Follow these steps to create a Go module.
 
-1. Open a console window where you want the new module, and then create a new file named *speech-synthesis.go*.
+1. Open a command prompt window in the folder where you want the new project. Create a new file named *speech-synthesis.go*.
 1. Copy the following code into *speech-synthesis.go*:
 
     ```go
@@ -146,7 +146,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.
+   > 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. Now build and run the code:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -16,10 +16,10 @@ ms.author: eur
 
 ## Set up the environment
 
-Before you can do anything, you need to [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.
+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.
 
 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:
+1. Create a *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">
@@ -127,7 +127,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. Enter some text that you want to speak. For example, type *I'm excited to try text to speech*. Select the **Enter** key to hear the synthesized speech.
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/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 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).
+To set up your environment, 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).
 
 ### Set environment variables
 
@@ -83,7 +83,7 @@ Follow these steps to create a Node.js console application for speech synthesis.
    }());
    ```
 
-1. In *SpeechSynthesis.js*, optionally you can rename *YourAudioFile.wav* to another output filename.
+1. In *SpeechSynthesis.js*, optionally you can rename *YourAudioFile.wav* to another output file name.
 
 1. To change the speech synthesis language, replace `en-US-JennyNeural` with another [supported voice](~/articles/ai-services/speech-service/language-support.md#prebuilt-neural-voices).
 
@@ -96,7 +96,7 @@ Follow these steps to create a Node.js console application for speech synthesis.
    ```
 
    > [!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. The provided text should be in an audio file:
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -30,7 +30,7 @@ Follow these steps to synthesize 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 [Synthesize audio in Objective-C on macOS using the Speech SDK](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/macos/text-to-speech) sample project. The repository also has iOS samples.
 1. Open 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. 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.
 
@@ -78,10 +78,10 @@ Follow these steps to synthesize speech in a macOS application.
    All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 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 input some text and select the button in the app, you should hear the synthesized audio played.
 
@@ -95,5 +95,3 @@ This quickstart uses the `SpeakText` operation to synthesize a short block of te
 ## Clean up resources
 
 [!INCLUDE [Delete resource](../../common/delete-resource.md)]
-
-

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -31,7 +31,7 @@ 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_synthesis.py*.
+1. Open a command prompt window in the folder where you want the new project. Create a file named *speech_synthesis.py*.
 1. Run this command to install the Speech SDK:  
 
    ```console
@@ -81,7 +81,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. Enter some text that you want to speak. For example, type *I'm excited to try text to speech*. Select the **Enter** key to hear the synthesized speech.
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -20,7 +20,7 @@ ms.author: eur
 
 ## Synthesize to a file
 
-At a command prompt, run the following cURL command. Optionally, you can rename *output.mp3* to another output filename.
+At a command prompt, run the following cURL command. Optionally, you can rename *output.mp3* to another output file name.
 
 # [Windows](#tab/windows)
 
@@ -66,7 +66,7 @@ curl --location --request POST "https://${SPEECH_REGION}.tts.speech.microsoft.co
 * * *
 
 > [!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 provided text should be output to an audio file named *output.mp3*.
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 08/25/2023
+ms.date: 01/29/2024
 ms.author: eur
 ---
 
@@ -30,7 +30,7 @@ Follow these steps to synthesize 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 [Synthesize audio in Swift on macOS using the Speech SDK](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/macos/text-to-speech) 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. 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.swift* and locate the `applicationDidFinishLaunching` and `synthesize` methods as shown here.
 
@@ -126,10 +126,10 @@ Follow these steps to synthesize speech in a macOS application.
    All neural voices are multilingual and fluent in their own language and English. For example, if the input text in English is "I'm excited to try text to speech" and you set `es-ES-ElviraNeural`, the text is spoken in English with a Spanish accent. If the voice doesn't speak the language of the input text, the Speech service doesn't output synthesized audio.
 
 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 input some text and select the button in the app, you should hear the synthesized audio played.