Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into apicvid

Author: dlepow

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/how-to-pronunciation-assessment.md

@@ -2,16 +2,17 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 02/28/2023
+ms.date: 02/08/2024
 ms.author: eur
 ---
 
-Your application must be authenticated to access Azure AI services resources. For production, use a secure way of storing and accessing your credentials. For example, after you [get a key](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource) for your <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Speech resource</a>, write it to a new environment variable on the local machine running the application.
+Your application must be authenticated to access Azure AI services resources. For production, use a secure way of storing and accessing your credentials. For example, after you [get a key](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource) for your Speech resource, write it to a new environment variable on the local machine running the application.
 
 > [!TIP]
-> Don't include the key directly in your code, and never post it publicly. See the Azure AI services [security](../../../security-features.md) article for more authentication options like [Azure Key Vault](../../../use-key-vault.md). 
+> Don't include the key directly in your code, and never post it publicly. See [Azure AI services security](../../../security-features.md) for more authentication options like [Azure Key Vault](../../../use-key-vault.md). 
+
+To set the environment variables, open a console window, and follow the instructions for your operating system and development environment.
 
-To set the environment variables, open a console window, and follow the instructions for your operating system and development environment. 
 - To set the `OPEN_AI_KEY` environment variable, replace `your-openai-key` with one of the keys for your resource.
 - To set the `OPEN_AI_ENDPOINT` environment variable, replace `your-openai-endpoint` with one of the regions for your resource.
 - To set the `OPEN_AI_DEPLOYMENT_NAME` environment variable, replace `your-openai-deployment-name` with one of the regions for your resource.
@@ -23,15 +24,15 @@ To set the environment variables, open a console window, and follow the instruct
 ```console
 setx OPEN_AI_KEY your-openai-key
 setx OPEN_AI_ENDPOINT your-openai-endpoint
-setx OPEN_AI_DEPLOYMENT_NAME=your-openai-deployment-name
+setx OPEN_AI_DEPLOYMENT_NAME your-openai-deployment-name
 setx SPEECH_KEY your-speech-key
 setx SPEECH_REGION your-speech-region
 ```
 
 > [!NOTE]
-> If you only need to access the environment variable in the current running console, you can set the environment variable with `set` instead of `setx`.
+> If you only need to access the environment variable in the current running console, set the environment variable with `set` instead of `setx`.
 
-After you add the environment variables, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you are using Visual Studio as your editor, restart Visual Studio before running the example.
+After you add the environment variables, you might need to restart any running programs that need to read the environment variable, including the console window. For example, if Visual Studio is your editor, restart Visual Studio before running the example.
 
 #### [Linux](#tab/linux)
 
@@ -46,10 +47,9 @@ export SPEECH_REGION=your-speech-region
 After you add the environment variables, run `source ~/.bashrc` from your console window to make the changes effective.
 
 #### [macOS](#tab/macos)
-
 ##### Bash
 
-Edit your .bash_profile, and add the environment variables:
+Edit your *.bash_profile*, and add the environment variables:
 
 ```bash
 export OPEN_AI_KEY=your-openai-key
@@ -63,11 +63,11 @@ After you add the environment variables, run `source ~/.bash_profile` from your
 
 ##### Xcode
 
-For iOS and macOS development, you set the environment variables in Xcode. For example, follow these steps to set the environment variable in Xcode 13.4.1.
+For iOS and macOS development, set the environment variables in Xcode. For example, follow these steps to set the environment variable in Xcode 13.4.1.
 
-1. Select **Product** > **Scheme** > **Edit scheme**
-1. Select **Arguments** on the **Run** (Debug Run) page
-1. Under **Environment Variables** select the plus (+) sign to add a new environment variable. 
+1. Select **Product** > **Scheme** > **Edit scheme**.
+1. Select **Arguments** on the **Run** (Debug Run) page.
+1. Under **Environment Variables** select the plus (+) sign to add a new environment variable.
 1. Enter `SPEECH_KEY` for the **Name** and enter your Speech resource key for the **Value**.
 
 Repeat the steps to set other required environment variables.

articles/ai-services/speech-service/includes/common/environment-variables-openai.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/how-to/compressed-audio-input/gstreamer-linux.md

@@ -196,9 +196,9 @@ speechConfig->SetSpeechRecognitionLanguage("de-DE");
 
 ## Language identification
 
-You can use [language identification](../../../language-identification.md?pivots=programming-language-cpp#speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
+You can use [language identification](../../../language-identification.md?pivots=programming-language-cpp#use-speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
 
-For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-cpp#speech-to-text).
+For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-cpp#use-speech-to-text).
 
 ## Use a custom endpoint
 

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

@@ -271,9 +271,9 @@ The [`SpeechRecognitionLanguage`](/dotnet/api/microsoft.cognitiveservices.speech
 
 ## Language identification
 
-You can use [language identification](../../../language-identification.md?pivots=programming-language-csharp#speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
+You can use [language identification](../../../language-identification.md?pivots=programming-language-csharp#use-speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
 
-For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-csharp#speech-to-text).
+For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-csharp#use-speech-to-text).
 
 ## Use a custom endpoint
 

articles/ai-services/speech-service/includes/how-to/recognize-speech/csharp.md

@@ -214,9 +214,9 @@ config.setSpeechRecognitionLanguage("fr-FR");
 
 ## Language identification
 
-You can use [language identification](../../../language-identification.md?pivots=programming-language-java#speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
+You can use [language identification](../../../language-identification.md?pivots=programming-language-java#use-speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
 
-For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-java#speech-to-text).
+For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-java#use-speech-to-text).
 
 ## Use a custom endpoint
 

articles/ai-services/speech-service/includes/how-to/recognize-speech/java.md

@@ -194,9 +194,9 @@ The [`speechRecognitionLanguage`](/javascript/api/microsoft-cognitiveservices-sp
 
 ## Language identification
 
-You can use [language identification](../../../language-identification.md?pivots=programming-language-javascript#speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
+You can use [language identification](../../../language-identification.md?pivots=programming-language-javascript#use-speech-to-text) with speech to text recognition when you need to identify the language in an audio source and then transcribe it to text.
 
-For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-javascript#speech-to-text).
+For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-javascript#use-speech-to-text).
 
 ## Use a custom endpoint