Merge pull request #264998 from TimShererWithAquent/us200722e

Freshness update: Azure AI Speech service

Author: v-dirichards

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,7 +12,7 @@ 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)
 

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.
 

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

@@ -6,19 +6,17 @@ 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 a .NET Core console app. .NET Core is an open-source, cross-platform .NET platform that implements the .NET Standard specification.
 
-## 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.
 - [.NET Core SDK](https://dotnet.microsoft.com/download).
-- [Visual Studio 2017](https://visualstudio.microsoft.com/downloads/) or later.
+- [Visual Studio 2017](https://visualstudio.microsoft.com/downloads/).
 
 ## Create a Visual Studio project and install the Speech SDK
 
@@ -36,9 +34,11 @@ This guide requires:
 
 1. Install and reference the [Speech SDK NuGet package](https://aka.ms/csspeech/nuget). In Solution Explorer, right-click the solution and select **Manage NuGet Packages for Solution**.
 
-   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-csharp-dotnetcore-windows-02-manage-nuget-packages.png" alt-text="Screenshot of Solution Explorer, with Manage NuGet Packages for Solution highlighted." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-csharp-dotnetcore-windows-02-manage-nuget-packages.png":::
+   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-csharp-dotnetcore-windows-02-manage-nuget-packages.png" alt-text="Screenshot of Solution Explorer, with Manage NuGet Packages for Solution highlighted.":::
+
+1. Select **Browse**, then in the upper-right corner, for **Package Source**, select **nuget.org**.
 
-1. In the upper-right corner, in the **Package Source** box, select **nuget.org**. Search for the **Microsoft.CognitiveServices.Speech** package, and install it into the **helloworld** project.
+1. Search for the *Microsoft.CognitiveServices.Speech* package, and install it into the **helloworld** project.
 
    :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-csharp-dotnetcore-windows-03-nuget-install-1.0.0.png" alt-text="Screenshot that shows the Manage Packages for Solution dialog box." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-csharp-dotnetcore-windows-03-nuget-install-1.0.0.png":::
 

articles/ai-services/speech-service/includes/quickstarts/platform/csharp-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,7 +12,7 @@ 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)
 

articles/ai-services/speech-service/includes/quickstarts/platform/csharp-unity.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
 ms.custom: devx-track-csharp
 ---
@@ -31,10 +31,8 @@ This guide requires:
 
 To install the Speech SDK for Unity, follow these steps:
 
-1. Download and open the [Speech SDK for Unity](https://aka.ms/csspeech/unitypackage). It's packaged as a Unity asset package (*.unitypackage*) and should already be associated with Unity. When the asset package is opened, the **Import Unity Package** dialog box appears. You might need to create and open an empty project for this step to work.
+1. Download and open the [Speech SDK for Unity](https://aka.ms/csspeech/unitypackage). The SDK is packaged as a Unity asset package (*.unitypackage*) and should already be associated with Unity. When the asset package is opened, the **Import Unity Package** dialog box appears. You might need to create and open an empty project for this step to work.
 
 1. Ensure that all files are selected, and then select **Import**. After a few moments, the Unity asset package is imported into your project.
 
-   :::image type="content" source="~/articles/ai-services/speech-service/media/sdk/qs-csharp-unity-01-import.png" alt-text="Screenshot of the Import Unity Package dialog box in the Unity Editor." lightbox="~/articles/ai-services/speech-service/media/sdk/qs-csharp-unity-01-import.png":::
-
 For more information about importing asset packages into Unity, see the [Unity documentation](https://docs.unity3d.com/Manual/AssetPackages.html).