Merge pull request #250309 from TimShererWithAquent/us141588h

Azure OpenAI Freshness Pass - User Story: 141588

Author: JamesJBarnett

articles/ai-services/speech-service/includes/quickstarts/platform/cpp-linux.md

@@ -8,11 +8,10 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 06/11/2022
+ms.date: 09/05/2023
 ms.author: eur
 ---
 
 This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for Linux.
 
 [!INCLUDE [linux-install-sdk](linux-install-sdk.md)]
-

articles/ai-services/speech-service/includes/quickstarts/platform/cpp-macos.md

@@ -8,38 +8,37 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 06/11/2022
+ms.date: 09/05/2023
 ms.author: eur
 ---
 
-This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++ on macOS 10.14 or later. The steps include downloading the required libraries and header files as a .zip file from https://aka.ms/csspeech/macosbinary.
+This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++ on macOS 10.14 or later. The steps include downloading the [required libraries and header files](https://aka.ms/csspeech/macosbinary) as a *.zip* file.
 
-1. Choose a directory to which the Speech SDK files should be extracted, and set the `SPEECHSDK_ROOT` environment variable to point to that directory. This variable makes it easy to refer to the directory in future commands. 
+1. Choose a directory to which the Speech SDK files should be extracted, and set the `SPEECHSDK_ROOT` environment variable to point to that directory. This variable makes it easy to refer to the directory in future commands.
 
-   For example, if you want to use the directory `speechsdk` in your home directory, use a command like the following:
+   For example, if you want to use the directory *speechsdk* in your home directory, use a command like the following example:
 
-   ```sh
+   ```console
    export SPEECHSDK_ROOT="$HOME/speechsdk"
    ```
 
-1. Create the directory if it doesn't exist yet:
+1. Create the directory if it doesn't exist:
 
-   ```sh
+   ```console
    mkdir -p "$SPEECHSDK_ROOT"
    ```
 
-1. Download and extract the .zip archive that contains the Speech SDK XCFramework:
+1. Download and extract the *.zip* archive that contains the Speech SDK XCFramework:
 
-   ```sh
+   ```console
    wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
    unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
    ```
 
 1. Validate the contents of the top-level directory of the extracted package:
 
-   ```sh
+   ```console
    ls -l "$SPEECHSDK_ROOT"
    ```
 
-   The directory listing should contain the third-party notice, license files, and a `MicrosoftCognitiveServicesSpeech.xcframework` directory.
-
+   The directory listing should contain the third-party notice, license files, and a *MicrosoftCognitiveServicesSpeech.xcframework* directory.

articles/ai-services/speech-service/includes/quickstarts/platform/cpp-requirements.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 06/10/2022
+ms.date: 09/05/2023
 ms.author: eur
 ---
 
@@ -16,7 +16,12 @@ You must install the [Microsoft Visual C++ Redistributable for Visual Studio 201
 
 # [Linux](#tab/linux)
 
-The Speech SDK for C++ only supports **Ubuntu 18.04/20.04/22.04**, **Debian 10/11**, **Red Hat Enterprise Linux (RHEL) 7/8**, and **CentOS 7/8** on the following architectures when used with Linux: x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu)
+The Speech SDK for C++ only supports the following distributions on the x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) architectures:
+
+- Ubuntu 18.04/20.04/22.04
+- Debian 10/11
+- Red Hat Enterprise Linux (RHEL) 7/8
+- CentOS 7/8
 
 [!INCLUDE [Linux distributions](linux-distributions.md)]
 

articles/ai-services/speech-service/includes/quickstarts/platform/cpp-windows.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 06/11/2022
+ms.date: 09/05/2023
 ms.author: eur
 ms.custom: ignite-fall-2021
 ---
@@ -17,8 +17,8 @@ This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-s
 
 This setup guide requires:
 
-* [Microsoft Visual C++ Redistributable for Visual Studio 2019](https://support.microsoft.com/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0) for the Windows platform. Installing it for the first time might require a restart.
-* [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/).
+- [Microsoft Visual C++ Redistributable for Visual Studio 2019](https://support.microsoft.com/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0) for the Windows platform. Installing it for the first time might require a restart.
+- [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/).
 
 ### Create a project in Visual Studio and install the Speech SDK
 
@@ -33,21 +33,21 @@ To create a Visual Studio project for C++ desktop development, you need to:
 
 To start, make sure you're set up correctly in Visual Studio for C++ desktop development:
 
-1. Open Visual Studio 2019 to display the start window.   
+1. Open Visual Studio 2019 to display the start window.
 
 1. Select **Continue without code** to go to the Visual Studio IDE.
 
-   ![Screenshot that shows the Visual Studio 2019 start window.](~/articles/ai-services/speech-service/media/sdk/vs-start-window.png)
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-start-window.png" alt-text="Screenshot that shows the Visual Studio 2019 start window." lightbox="~/articles/ai-services/speech-service/media/sdk/vs-start-window.png":::
 
-1. From the Visual Studio menu bar, select **Tools** > **Get Tools and Features** to open Visual Studio Installer and view the **Modifying** dialog.   
+1. From the Visual Studio menu bar, select **Tools** > **Get Tools and Features** to open Visual Studio Installer and view the **Modifying** dialog box.
 
-1. On the **Workloads** tab, under **Windows**, find the **Desktop development with C++** workload. If the check box next to that workload isn't already selected, select it.
+1. On the **Workloads** tab, under **Windows**, find the **Desktop development with C++** workload. If that workload isn't already selected, select it.
 
-   ![Screenshot that shows the Workloads tab of the Modifying dialog for Visual Studio Installer.](~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-workload.png)
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-workload.png" alt-text="Screenshot that shows the Workloads tab of the Modifying dialog box for Visual Studio Installer." lightbox="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-workload.png":::
 
-1. On the **Individual components** tab, find the **NuGet package manager** check box. If the check box isn't already selected, select it.
+1. On the **Individual components** tab, find the **NuGet package manager** check box. If it isn't already selected, select it.
 
-1. In the corner, select the button labeled either **Close** or **Modify**. The button name varies depending on whether you selected any features for installation. 
+1. In the corner, select either **Close** or **Modify**. The button name varies depending on whether you selected any features for installation.
 
    If you select **Modify**, installation begins. The process might take a while.
 
@@ -57,45 +57,44 @@ To start, make sure you're set up correctly in Visual Studio for C++ desktop dev
 
 Next, create your project and select the target architecture:
 
-1. On the Visual Studio menu bar, select **File** > **New** > **Project** to display the **Create a new project** window.
-   
+1. From the Visual Studio menu, select **File** > **New** > **Project** to display the **Create a new project** window.
+
 1. Find and select **Console App**. Make sure that you select the C++ version of this project type, as opposed to C# or Visual Basic.
 
 1. Select **Next**.
 
-   ![Screenshot of selections for creating a console app project in Visual Studio.](~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-01-new-console-app.png)   
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-01-new-console-app.png" alt-text="Screenshot of selections for creating a console app project in Visual Studio." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-01-new-console-app.png":::
 
-1. In the **Configure your new project** dialog, in **Project name**, enter **helloworld**.
+1. In the **Configure your new project** dialog box, in **Project name**, enter *helloworld*.
 
-1. In **Location**, go to and select (or create) the folder where you want to save your project, and then select **Create**.
+1. In **Location**, go to and select or create the folder where you want to save your project, and then select **Create**.
 
-   ![Screenshot of selections for configuring a new project in Visual Studio.](~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-configure-your-new-project.png)
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-configure-your-new-project.png" alt-text="Screenshot of selections for configuring a new project in Visual Studio." lightbox="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-configure-your-new-project.png":::
 
-1. Select your target platform architecture. On the Visual Studio toolbar, find the **Solution Platforms** drop-down box. If you don't see it, select **View** > **Toolbars** > **Standard** to display the toolbar that contains **Solution Platforms**.
+1. Select your target platform architecture. On the Visual Studio toolbar, find the **Solution Platforms** dropdown box. If you don't see it, select **View** > **Toolbars** > **Standard** to display the toolbar that contains **Solution Platforms**.
 
-   If you're running 64-bit Windows, select **x64** in the drop-down box. 64-bit Windows can also run 32-bit applications, so you can choose **x86** if you prefer.
+   If you're running 64-bit Windows, select **x64** in the dropdown box. 64-bit Windows can also run 32-bit applications, so you can choose **x86** if you prefer.
 
 #### Install the Speech SDK by using Visual Studio
 
 Finally, install the [Speech SDK NuGet package](https://aka.ms/csspeech/nuget) and reference the Speech SDK in your project:
 
 1. In Solution Explorer, right-click your solution, and then select **Manage NuGet Packages for Solution** to go to the **NuGet - Solution** window.
 
-1. Select **Browse**.   
+1. Select **Browse**.
 
 1. In **Package source**, select **nuget.org**.
 
-   ![Screenshot that shows the Manage NuGet Packages for Solution dialog, with the Browse tab, search box, and package source highlighted.](~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-03-manage-nuget-packages.png)
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-03-manage-nuget-packages.png" alt-text="Screenshot that shows the Manage NuGet Packages for Solution dialog box, with the Browse tab, search box, and package source highlighted." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-03-manage-nuget-packages.png":::
 
 1. In the **Search** box, enter **Microsoft.CognitiveServices.Speech**. Choose that package after it appears in the search results.
 
 1. In the package status pane next to the search results, select your **helloworld** project.
 
 1. Select **Install**.
 
-   ![Screenshot that shows the Microsoft.CognitiveServices.Speech package selected, with the project and the Install button highlighted.](~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-04-nuget-install-1.0.0.png)
-
-1. In the **Preview Changes** dialog, select **OK**.
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-04-nuget-install-1.0.0.png" alt-text="Screenshot that shows the Microsoft.CognitiveServices.Speech package selected, with the project and the Install button highlighted." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-04-nuget-install-1.0.0.png":::
 
-1. In the **License Acceptance** dialog, view the license, and then select **I Accept**. The package installation begins. When installation is complete, the **Output** pane displays a message that's similar to the following text: `Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld`.
+1. In the **Preview Changes** dialog box, select **OK**.
 
+1. In the **License Acceptance** dialog box, view the license, and then select **I Accept**. The package installation begins. When installation is complete, the **Output** pane displays a message that's similar to the following text: `Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld`.

articles/ai-services/speech-service/includes/quickstarts/platform/cpp.md

@@ -2,43 +2,41 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 06/11/2022
+ms.date: 09/05/2023
 ms.author: eur
 ---
 
 [!INCLUDE [Header](../../common/cpp.md)]
 
-This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++. 
+This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++.
 
 ## Platform requirements
 
 [!INCLUDE [Requirements](cpp-requirements.md)]
 
 ## Install the Speech SDK for C++
 
-The Speech SDK for C++ is available as a NuGet package. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech</a>.
+The Speech SDK for C++ is available as a NuGet package. For more information, see [Microsoft.CognitiveServices.Speech](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech).
 
 # [Terminal](#tab/dotnetcli)
 
-The Speech SDK for C# can be installed from the .NET CLI with the following `dotnet add` command:
+The Speech SDK for C# can be installed from the .NET CLI by using the following `dotnet add` command:
 
 ```dotnetcli
 dotnet add package Microsoft.CognitiveServices.Speech
 ```
 
 # [PowerShell](#tab/powershell)
 
-The Speech SDK for C# can be installed with the following `Install-Package` command:
+The Speech SDK for C# can be installed by using the following `Install-Package` command:
 
 ```powershell
 Install-Package Microsoft.CognitiveServices.Speech
 ```
 
 ---
 
-You can follow a guide below for additional options.
-
-**Choose your target environment**
+You can follow these guides for more options.
 
 # [Linux](#tab/linux)
 
@@ -52,4 +50,4 @@ You can follow a guide below for additional options.
 
 [!INCLUDE [windows](cpp-windows.md)]
 
-* * *
+---