Merge pull request #249263 from TimShererWithAquent/us141588e

Azure OpenAI Freshness Pass - User Story: 141588

Author: v-dirichards

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

@@ -1,14 +1,14 @@
 ---
 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 output formats, and custom configuration options for speech synthesis.
+description: In this quickstart, you convert text to speech. Learn about object construction and design patterns, supported audio formats, and custom configuration options.
 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/25/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/quickstarts/text-to-speech-basics/cli.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 03/15/2022
+ms.date: 08/25/2023
 ms.author: eur
 ---
 
@@ -18,30 +18,31 @@ ms.author: eur
 
 ## Synthesize to speaker output
 
-Run the following command for speech synthesis to the default speaker output. You can modify the text to be synthesized and the voice.
+Run the following command for speech synthesis to the default speaker output. You can modify the voice and the text to be synthesized.
 
 ```console
 spx synthesize --text "I'm excited to try text to speech" --voice "en-US-JennyNeural"
 ```
 
-If you don't set a voice name, the default voice for `en-US` will speak. 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 `--voice "es-ES-ElviraNeural"`, the text is spoken in English with a Spanish accent. If the voice does not speak the language of the input text, the Speech service won't output synthesized audio.
+If you don't set a voice name, the default voice for `en-US` speaks.
 
-## Remarks
+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 `--voice "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.
 
-Now that you've completed the quickstart, here are some additional considerations:
+## Remarks
 
 You can have finer control over voice styles, prosody, and other settings by using [Speech Synthesis Markup Language (SSML)](~/articles/ai-services/speech-service/speech-synthesis-markup.md).
 
-In the following example, the voice and style ('excited') are provided in the SSML block. 
+- In the following example, the voice and style, `excited`, are provided in the SSML block.
 
-```console
-spx synthesize --ssml "<speak version='1.0' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='https://www.w3.org/2001/mstts' xml:lang='en-US'><voice name='en-US-JennyNeural'><mstts:express-as style='excited'>I'm excited to try text to speech</mstts:express-as></voice></speak>"
-```
+  ```console
+  spx synthesize --ssml "<speak version='1.0' xmlns='http://www.w3.org/2001/10/synthesis' xmlns:mstts='https://www.w3.org/2001/mstts' xml:lang='en-US'><voice name='en-US-JennyNeural'><mstts:express-as style='excited'>I'm excited to try text to speech</mstts:express-as></voice></speak>"
+  ```
 
-Run this command for information about additional speech synthesis options such as file input and output:
-```console
-spx help synthesize
-```
+- Run this command for information about more speech synthesis options such as file input and output:
+
+  ```console
+  spx help synthesize
+  ```
 
 ## Clean up resources
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 09/27/2022
+ms.date: 08/25/2023
 ms.author: eur
 ---
 
@@ -15,7 +15,8 @@ ms.author: eur
 [!INCLUDE [Prerequisites](../../common/azure-prerequisites.md)]
 
 ## 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, but first check the [SDK installation guide](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp) for any more requirements.
+
+The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide. For any requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-cpp).
 
 ### Set environment variables
 
@@ -25,13 +26,15 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 Follow these steps to create a new console application and install the Speech SDK.
 
-1. Create a new C++ console project in Visual Studio Community 2022 named `SpeechSynthesis`.
+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:
-    
+
+   ```powershell
+   Install-Package Microsoft.CognitiveServices.Speech
+   ```
+
+1. Replace the contents of *SpeechSynthesis.cpp* with the following code:
+
     ```cpp
     #include <iostream> 
     #include <stdlib.h>
@@ -108,26 +111,28 @@ Follow these steps to create a new console application and install the Speech SD
     }  
     ```
 
-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 does not speak the language of the input text, the Speech service won't output synthesized audio.
+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.
 
-[Build and run your new console application](/cpp/build/vscpp-step-2-build) to start speech synthesis to the default speaker.
+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 [above](#set-environment-variables). If you don't set these variables, the sample will fail with an error message.
+   > [!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.
 
-Enter some text that you want to speak. For example, type "I'm excited to try text to speech." Press the Enter key to hear the synthesized speech. 
+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.
 
-```console
-Enter some text that you want to speak >
-I'm excited to try text to speech
-```
+   ```console
+   Enter some text that you want to speak >
+   I'm excited to try text to speech
+   ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
 
 This quickstart uses the `SpeakTextAsync` operation to synthesize a short block of text that you enter. You can also get text from files as described in these guides:
-- For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/ai-services/speech-service/how-to-speech-synthesis.md) and [Improve synthesis with Speech Synthesis Markup Language (SSML)](~/articles/ai-services/speech-service/speech-synthesis-markup.md).
-- For information about synthesizing long-form text to speech, see [batch synthesis](~/articles/ai-services/speech-service/batch-synthesis.md). 
+
+- For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/ai-services/speech-service/how-to-speech-synthesis.md) and [Speech Synthesis Markup Language (SSML) overview](~/articles/ai-services/speech-service/speech-synthesis-markup.md).
+- For information about synthesizing long-form text to speech, see [Batch synthesis API for text to speech](~/articles/ai-services/speech-service/batch-synthesis.md).
 
 ## Clean up resources
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 03/15/2022
+ms.date: 08/25/2023
 ms.author: eur
 ---
 
@@ -15,7 +15,8 @@ ms.author: eur
 [!INCLUDE [Prerequisites](../../common/azure-prerequisites.md)]
 
 ## 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, but first check the [SDK installation guide](../../../quickstarts/setup-platform.md?pivots=programming-language-csharp) for any more requirements. 
+
+The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech) that implements .NET Standard 2.0. Install the Speech SDK later in this guide. For any requirements, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-csharp).
 
 ### Set environment variables
 
@@ -25,16 +26,20 @@ The Speech SDK is available as a [NuGet package](https://www.nuget.org/packages/
 
 Follow these steps to create a new console application and install the Speech SDK.
 
-1. Open a command prompt where you want the new project, and create a console application with the .NET CLI. The `Program.cs` file should be created in the project directory.
-    ```dotnetcli
-    dotnet new console
-    ```
+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.
+
+   ```dotnetcli
+   dotnet new console
+   ```
+
 1. Install the Speech SDK in your new project with the .NET CLI.
-    ```dotnetcli
-    dotnet add package Microsoft.CognitiveServices.Speech
-    ```
-1. Replace the contents of `Program.cs` with the following code. 
-    
+
+   ```dotnetcli
+   dotnet add package Microsoft.CognitiveServices.Speech
+   ```
+
+1. Replace the contents of *Program.cs* with the following code.
+
     ```csharp
     using System;
     using System.IO;
@@ -94,30 +99,32 @@ Follow these steps to create a new console application and install the Speech SD
     }
     ```
 
-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 does not speak the language of the input text, the Speech service won't output synthesized audio.
+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).
 
-[Build and run](/cpp/build/vscpp-step-2-build) your new console application to start speech synthesis to the default speaker.
+   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.
 
-```console
-dotnet run
-```
+1. Run your new console application to start speech synthesis to the default speaker.
 
-> [!IMPORTANT]
-> Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described [above](#set-environment-variables). If you don't set these variables, the sample will fail with an error message.
+   ```console
+   dotnet run
+   ```
 
-Enter some text that you want to speak. For example, type "I'm excited to try text to speech." Press the Enter key to hear the synthesized speech. 
+   > [!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.
 
-```console
-Enter some text that you want to speak >
-I'm excited to try text to speech
-```
+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.
+
+   ```console
+   Enter some text that you want to speak >
+   I'm excited to try text to speech
+   ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
 
 This quickstart uses the `SpeakTextAsync` operation to synthesize a short block of text that you enter. You can also get text from files as described in these guides:
-- For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/ai-services/speech-service/how-to-speech-synthesis.md) and [Improve synthesis with Speech Synthesis Markup Language (SSML)](~/articles/ai-services/speech-service/speech-synthesis-markup.md).
-- For information about synthesizing long-form text to speech, see [batch synthesis](~/articles/ai-services/speech-service/batch-synthesis.md). 
+
+- For information about speech synthesis from a file and finer control over voice styles, prosody, and other settings, see [How to synthesize speech](~/articles/ai-services/speech-service/how-to-speech-synthesis.md) and [Speech Synthesis Markup Language (SSML) overview](~/articles/ai-services/speech-service/speech-synthesis-markup.md).
+- For information about synthesizing long-form text to speech, see [Batch synthesis API for text to speech](~/articles/ai-services/speech-service/batch-synthesis.md).
 
 ## Clean up resources
 

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 03/15/2022
+ms.date: 08/25/2023
 ms.author: eur
 ---
 
@@ -16,18 +16,18 @@ ms.author: eur
 
 ## Set up the environment
 
-Install the [Speech SDK for Go](../../../quickstarts/setup-platform.md?pivots=programming-language-go&tabs=dotnet%252cwindows%252cjre%252cbrowser). Check the [SDK installation guide](../../../quickstarts/setup-platform.md?pivots=programming-language-go) for any more requirements.
+Install the Speech SDK for Go. For requirements and instructions, see [Install the Speech SDK](../../../quickstarts/setup-platform.md?pivots=programming-language-go).
 
 ### Set environment variables
 
 [!INCLUDE [Environment variables](../../common/environment-variables.md)]
 
 ## Synthesize to speaker output
 
-Follow these steps to create a new GO module.
+Follow these steps to create a new Go module.
 
-1. Open a command prompt where you want the new module, and create a new file named `speech-synthesis.go`.
-1. Copy the following code into `speech_synthesis.go`:
+1. Open a console window where you want the new module, and then create a new file named *speech-synthesis.go*.
+1. Copy the following code into *speech-synthesis.go*:
 
     ```go
     package main
@@ -134,24 +134,26 @@ Follow these steps to create a new GO module.
     }
     ```
 
-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 does not speak the language of the input text, the Speech service won't output synthesized audio.
+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).
 
-Run the following commands to create a `go.mod` file that links to components hosted on GitHub:
+   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.
 
-```cmd
-go mod init speech-synthesis
-go get github.com/Microsoft/cognitive-services-speech-sdk-go
-```
+1. Run the following commands to create a *go.mod* file that links to components hosted on GitHub:
 
-> [!IMPORTANT]
-> Make sure that you set the `SPEECH_KEY` and `SPEECH_REGION` environment variables as described [above](#set-environment-variables). If you don't set these variables, the sample will fail with an error message.
+   ```console
+   go mod init speech-synthesis
+   go get github.com/Microsoft/cognitive-services-speech-sdk-go
+   ```
 
-Now build and run the code:
+   > [!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.
 
-```cmd
-go build
-go run speech-synthesis
-```
+1. Now build and run the code:
+
+   ```console
+   go build
+   go run speech-synthesis
+   ```
 
 ## Clean up resources
 

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

@@ -2,11 +2,11 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 06/06/2023
+ms.date: 08/25/2023
 ms.author: eur
 ---
 
-In this quickstart, you run an application that does text to speech synthesis. 
+In this quickstart, you run an application that does text to speech synthesis.
 
 > [!TIP]
 > You can try text to speech in the [Speech Studio Voice Gallery](https://aka.ms/speechstudio/voicegallery) without signing up or writing any code.