Merge pull request #249846 from TimShererWithAquent/us141588g

Azure OpenAI Freshness Pass - User Story: 141588

Author: denrea

articles/ai-services/speech-service/how-to-speech-synthesis.md

@@ -1,15 +1,15 @@
 ---
 title: "How to synthesize speech from text - Speech service"
 titleSuffix: Azure AI services
-description: Learn how to convert text to speech. Learn about object construction and design patterns, supported audio output formats, and custom configuration options for speech synthesis.
+description: Learn how to convert text to speech, including object construction and design patterns, supported audio output formats, and custom configuration options.
 services: cognitive-services
 author: eric-urban
 ms.author: eur
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: how-to
-ms.date: 09/16/2022
+ms.date: 08/30/2023
 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

articles/ai-services/speech-service/includes/how-to/speech-synthesis/cli.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 08/11/2020
+ms.date: 08/30/2023
 ms.author: eur
 ---
 
@@ -18,27 +18,28 @@ ms.author: eur
 
 ## Synthesize speech to a speaker
 
-Now you're ready to run the Speech CLI to synthesize speech from text. From the command line, change to the directory that contains the Speech CLI binary file. Then run the following command:
+Now you're ready to run the Speech CLI to synthesize speech from text.
 
-```bash
-spx synthesize --text "I'm excited to try text to speech"
-```
+- In a console window, change to the directory that contains the Speech CLI binary file. Then run the following command:
 
-The Speech CLI will produce natural language in English through the computer speaker.
+  ```console
+  spx synthesize --text "I'm excited to try text to speech"
+  ```
+
+The Speech CLI produces natural language in English through the computer speaker.
 
 ## Synthesize speech to a file
 
-Run the following command to change the output from your speaker to a .wav file:
+- Run the following command to change the output from your speaker to a *.wav* file:
 
-```bash
-spx synthesize --text "I'm excited to try text to speech" --audio output greetings.wav
-```
+  ```console
+  spx synthesize --text "I'm excited to try text to speech" --audio output greetings.wav
+  ```
 
-The Speech CLI will produce natural language in English in the `greetings.wav` audio file.
+The Speech CLI produces natural language in English to the *greetings.wav* audio file.
 
 ## Run and use a container
 
 Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
 
-For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
-
+For more information about containers, see [Install and run Speech containers with Docker](../../../speech-container-howto.md).

articles/ai-services/speech-service/includes/how-to/speech-synthesis/cpp.md

@@ -3,20 +3,20 @@ author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 11/14/2022
+ms.date: 08/30/2023
 ms.author: eur
 ---
 
 
 | Event | Description | Use case |
-| --- | --- | --- |
-|`BookmarkReached`|Signals that a bookmark was reached. To trigger a bookmark reached event, a `bookmark` element is required in the [SSML](../../../speech-synthesis-markup-structure.md#bookmark-element). This event reports the output audio's elapsed time between the beginning of synthesis and the `bookmark` element. The event's `Text` property is the string value that you set in the bookmark's `mark` attribute. The `bookmark` elements won't be spoken.|You can use the `bookmark` element to insert custom markers in SSML to get the offset of each marker in the audio stream. The `bookmark` element can be used to reference a specific location in the text or tag sequence.|
-|`SynthesisCanceled`|Signals that the speech synthesis was canceled.|You can confirm when synthesis has been canceled.|
-|`SynthesisCompleted`|Signals that speech synthesis has completed.|You can confirm when synthesis has completed.|
-|`SynthesisStarted`|Signals that speech synthesis has started.|You can confirm when synthesis has started.|
-|`Synthesizing`|Signals that speech synthesis is ongoing. This event fires each time the SDK receives an audio chunk from the Speech service.|You can confirm when synthesis is in progress.|
-|`VisemeReceived`|Signals that a viseme event was received.|[Visemes](../../../how-to-speech-synthesis-viseme.md) are often used to represent the key poses in observed speech. Key poses include the position of the lips, jaw, and tongue in producing a particular phoneme. You can use visemes to animate the face of a character as speech audio plays.|
-|`WordBoundary`|Signals that a word boundary was received. This event is raised at the beginning of each new spoken word, punctuation, and sentence. The event reports the current word's time offset (in ticks) from the beginning of the output audio. This event also reports the character position in the input text (or [SSML](../../../speech-synthesis-markup.md)) immediately before the word that's about to be spoken.|This event is commonly used to get relative positions of the text and corresponding audio. You might want to know about a new word, and then take action based on the timing. For example, you can get information that can help you decide when and for how long to highlight words as they're spoken.|
+|:--- |:--- |:--- |
+| `BookmarkReached` | Signals that a bookmark was reached. To trigger a bookmark reached event, a `bookmark` element is required in the [SSML](../../../speech-synthesis-markup-structure.md#bookmark-element). This event reports the output audio's elapsed time between the beginning of synthesis and the `bookmark` element. The event's `Text` property is the string value that you set in the bookmark's `mark` attribute. The `bookmark` elements aren't spoken. | You can use the `bookmark` element to insert custom markers in SSML to get the offset of each marker in the audio stream. The `bookmark` element can be used to reference a specific location in the text or tag sequence. |
+| `SynthesisCanceled` | Signals that the speech synthesis was canceled. | You can confirm when synthesis has been canceled. |
+| `SynthesisCompleted` | Signals that speech synthesis has completed. | You can confirm when synthesis has completed. |
+| `SynthesisStarted` | Signals that speech synthesis has started. | You can confirm when synthesis has started. |
+| `Synthesizing` | Signals that speech synthesis is ongoing. This event fires each time the SDK receives an audio chunk from the Speech service. | You can confirm when synthesis is in progress. |
+| `VisemeReceived` | Signals that a viseme event was received. | [Visemes](../../../how-to-speech-synthesis-viseme.md) are often used to represent the key poses in observed speech. Key poses include the position of the lips, jaw, and tongue in producing a particular phoneme. You can use visemes to animate the face of a character as speech audio plays. |
+| `WordBoundary` | Signals that a word boundary was received. This event is raised at the beginning of each new spoken word, punctuation, and sentence. The event reports the current word's time offset, in ticks, from the beginning of the output audio. This event also reports the character position in the input text or [SSML](../../../speech-synthesis-markup.md) immediately before the word that's about to be spoken. | This event is commonly used to get relative positions of the text and corresponding audio. You might want to know about a new word, and then take action based on the timing. For example, you can get information that can help you decide when and for how long to highlight words as they're spoken. |
 
 > [!NOTE]
-> Events are raised as the output audio data becomes available, which will be faster than playback to an output device. The caller must appropriately synchronize streaming and real-time.
+> Events are raised as the output audio data becomes available, which is faster than playback to an output device. The caller must appropriately synchronize streaming and real-time.