Merge pull request #266028 from MicrosoftDocs/main

02/12 AM Publishing

Author: v-alje

articles/ai-services/speech-service/embedded-speech.md

@@ -14,6 +14,9 @@ zone_pivot_groups: programming-languages-set-thirteen
 
 # Embedded Speech
 
+> [!CAUTION]
+> This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly.
+
 Embedded Speech is designed for on-device [speech to text](speech-to-text.md) and [text to speech](text-to-speech.md) scenarios where cloud connectivity is intermittent or unavailable. For example, you can use embedded speech in industrial equipment, a voice enabled air conditioning unit, or a car that might travel out of range. You can also develop hybrid cloud and offline solutions. For scenarios where your devices must be in a secure environment like a bank or government entity, you should first consider [disconnected containers](../containers/disconnected-containers.md). 
 
 > [!IMPORTANT]

articles/ai-services/speech-service/how-to-configure-openssl-linux.md

@@ -14,6 +14,9 @@ zone_pivot_groups: programming-languages-set-three
 
 # Configure OpenSSL for Linux
 
+> [!CAUTION]
+> This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly.
+
 With the Speech SDK, [OpenSSL](https://www.openssl.org) is dynamically configured to the host-system version. 
 
 > [!NOTE]

articles/ai-services/speech-service/how-to-configure-rhel-centos-7.md

@@ -12,6 +12,9 @@ ms.author: pankopon
 
 # Configure RHEL/CentOS 7
 
+> [!CAUTION]
+> This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly.
+
 To use the Speech SDK on Red Hat Enterprise Linux (RHEL) 7 x64 and CentOS 7 x64, update the C++ compiler (for C++ development) and the shared C++ runtime library on your system.
 
 ## Install dependencies

articles/ai-services/speech-service/includes/how-to/compressed-audio-input/gstreamer-linux.md

@@ -20,6 +20,9 @@ gstreamer1.0-plugins-ugly
 
 # [RHEL/CentOS](#tab/centos)
 
+> [!CAUTION]
+> This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly.
+
 ```sh
 sudo yum install gstreamer1 \
 gstreamer1-plugins-base \
@@ -29,7 +32,7 @@ gstreamer1-plugins-ugly-free
 ```
 
 > [!NOTE]
-> On RHEL/CentOS 7 and RHEL/CentOS 8, in case of using "ANY" compressed format, more GStreamer plug-ins need to be installed if the stream media format plug-in isn't in the preceding installed plug-ins. 
+> On RHEL/CentOS 7 and RHEL/CentOS 8, in case of using "ANY" compressed format, more GStreamer plug-ins need to be installed if the stream media format plug-in isn't in the preceding installed plug-ins.
 
 ---
 

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

@@ -6,7 +6,7 @@ author: markamos
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 ms.author: eur
 ---
 

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

@@ -6,15 +6,15 @@ author: markamos
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 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](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 for the Speech SDK files. 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 example:
+   To use the directory *speechsdk* in your home directory, run the following command:
 
    ```console
    export SPEECHSDK_ROOT="$HOME/speechsdk"
@@ -39,4 +39,4 @@ This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-s
    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 partner 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: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 ms.author: eur
 ---
 
@@ -12,10 +12,13 @@ The Speech SDK for C++ is compatible with Windows, Linux, and macOS.
 
 On Windows, you must use the 64-bit target architecture. Windows 10 or later is required.
 
-You must install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022](/cpp/windows/latest-supported-vc-redist?view=msvc-170&preserve-view=true) for your platform. Installing this package for the first time might require a restart.
+Install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, 2019, and 2022](/cpp/windows/latest-supported-vc-redist?view=msvc-170&preserve-view=true) for your platform. Installing this package for the first time might require a restart.
 
 # [Linux](#tab/linux)
 
+> [!CAUTION]
+> This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly.
+
 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

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

@@ -6,16 +6,16 @@ author: markamos
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 ms.author: eur
 ---
 
 This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++ on Windows desktop operating systems.
 
 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](/cpp/windows/latest-supported-vc-redist) for the Windows platform. Installing it for the first time might require a restart.
+- [Visual Studio](https://visualstudio.microsoft.com/downloads/).
 
 ### Create a project in Visual Studio and install the Speech SDK
 
@@ -34,17 +34,17 @@ To start, make sure you're set up correctly in Visual Studio for C++ desktop dev
 
 1. Select **Continue without code** to go to the Visual Studio IDE.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-start-window-inline.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 box.
 
 1. On the **Workloads** tab, under **Windows**, find the **Desktop development with C++** workload. If that workload isn't already selected, select it.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-workload-inline.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 it isn't already selected, select it.
+1. On the **Individual components** tab, find **NuGet package manager**. If it isn't already selected, select it.
 
-1. In the corner, select either **Close** or **Modify**. The button name varies depending on whether you selected any features for installation.
+1. 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.
 
@@ -60,13 +60,13 @@ Next, create your project and select the target architecture:
 
 1. Select **Next**.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-01-new-console-app-inline.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 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**.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-cpp-configure-your-new-project-inline.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** dropdown box. If you don't see it, select **View** > **Toolbars** > **Standard** to display the toolbar that contains **Solution Platforms**.
 
@@ -82,15 +82,15 @@ Finally, install the [Speech SDK NuGet package](https://aka.ms/csspeech/nuget) a
 
 1. In **Package source**, select **nuget.org**.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-03-manage-nuget-packages-inline.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**.
 
-   :::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":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-cpp-windows-04-nuget-install-1.0.0-inline.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 **Preview Changes** dialog box, select **OK**.
 

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

@@ -2,13 +2,13 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 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++.
+In this quickstart, you install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for C++.
 
 ## Platform requirements
 
@@ -20,15 +20,15 @@ The Speech SDK for C++ is available as a NuGet package. For more information, se
 
 # [Terminal](#tab/dotnetcli)
 
-The Speech SDK for C# can be installed from the .NET CLI by using 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 by using 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

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

@@ -6,41 +6,39 @@ author: markamos
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 09/05/2023
+ms.date: 02/02/2024
 ms.author: eur
 ms.custom: devx-track-dotnet
 ---
 
 This guide shows how to install the [Speech SDK](~/articles/ai-services/speech-service/speech-sdk.md) for a .NET Framework (Windows) console app.
 
-### Prerequisites
-
 This 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/).
+- [Visual Studio](https://visualstudio.microsoft.com/downloads/).
 
 ### Create a Visual Studio project and install the Speech SDK
 
 You need to install the [Speech SDK NuGet package](https://aka.ms/csspeech/nuget) so you can reference it in your code. To do that, you might first need to create a **helloworld** project. If you already have a project with the **.NET desktop development** workload available, you can use that project and skip to [Use NuGet Package Manager to install the Speech SDK](#use-nuget-package-manager-to-install-the-speech-sdk).
 
 #### Create a helloworld project
 
-1. Open Visual Studio 2019.
+1. Open Visual Studio.
 
-1. In the **Start** window, select **Create a new project**.
+1. Under **Get started**, select **Create a new project**.
 
-1. In the **Create a new project** window, choose **Console App (.NET Framework)**, and then select **Next**.
+1. In **Create a new project**, choose **Console App (.NET Framework)**, and then select **Next**.
 
-1. In the **Configure your new project** window, enter *helloworld* in **Project name**, choose or create the directory path in **Location**, and then select **Create**.
+1. In **Configure your new project**, for **Project name** enter *helloworld*, choose or create the directory path in **Location**, and then select **Create**.
 
 1. From the Visual Studio menu bar, select **Tools** > **Get Tools and Features**. This step opens Visual Studio Installer and displays the **Modifying** dialog box.
 
-1. Check whether the **.NET desktop development** workload is available. If the workload hasn't been installed, select it, and then select **Modify** to start the installation. It might take a few minutes to download and install.
+1. Check whether the **.NET desktop development** workload is available. If the workload isn't installed, select it, and then select **Modify** to start the installation. It might take a few minutes to download and install.
 
    If **.NET desktop development** is already selected, select **Close** to close the dialog box.
 
-   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-net-desktop-workload.png" alt-text="Screenshot that shows enabling .NET desktop development." lightbox="~/articles/ai-services/speech-service/media/sdk/vs-enable-net-desktop-workload.png":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/vs-enable-net-desktop-workload-inline.png" alt-text="Screenshot that shows enabling .NET desktop development." lightbox="~/articles/ai-services/speech-service/media/sdk/vs-enable-net-desktop-workload.png":::
 
 1. Close Visual Studio Installer.