Merge pull request #265962 from MicrosoftDocs/main

Publish to live, Sunday 4 AM PST, 2/11

Author: ttorble

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

@@ -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
 

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

@@ -161,9 +161,9 @@ speech_config.speech_recognition_language="de-DE"
 
 ## Language identification
 
-You can use [language identification](../../../language-identification.md?pivots=programming-language-python#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-python#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-python#speech-to-text).
+For a complete code sample, see [Language identification](../../../language-identification.md?pivots=programming-language-python#use-speech-to-text).
 
 ## Use a custom endpoint
 

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

@@ -299,7 +299,7 @@ For more information about speech synthesis, see [the basics of speech synthesis
 
 ## Multilingual translation with language identification
 
-In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-cpp#speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
+In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-cpp#run-speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
 
 The following example anticipates that `en-US` or `zh-CN` should be detected because they're defined in `AutoDetectSourceLanguageConfig`. Then, the speech will be translated to `de` and `fr` as specified in the calls to `AddTargetLanguage()`.
 
@@ -310,7 +310,7 @@ auto autoDetectSourceLanguageConfig = AutoDetectSourceLanguageConfig::FromLangua
 auto translationRecognizer = TranslationRecognizer::FromConfig(speechTranslationConfig, autoDetectSourceLanguageConfig, audioConfig);
 ```
 
-For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-cpp#speech-translation).
+For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-cpp#run-speech-translation).
 
 [speechtranslationconfig]: /cpp/cognitive-services/speech/translation-speechtranslationconfig
 [audioconfig]: /cpp/cognitive-services/speech/audio-audioconfig

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

@@ -306,7 +306,7 @@ For more information about speech synthesis, see [the basics of speech synthesis
 
 ## Multi-lingual translation with language identification
 
-In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-csharp#speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
+In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-csharp#run-speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
 
 The following example anticipates that `en-US` or `zh-CN` should be detected because they're defined in `AutoDetectSourceLanguageConfig`. Then, the speech is translated to `de` and `fr` as specified in the calls to `AddTargetLanguage()`.
 
@@ -317,7 +317,7 @@ var autoDetectSourceLanguageConfig = AutoDetectSourceLanguageConfig.FromLanguage
 var translationRecognizer = new TranslationRecognizer(speechTranslationConfig, autoDetectSourceLanguageConfig, audioConfig)
 ```
 
-For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-csharp#speech-translation).
+For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-csharp#run-speech-translation).
 
 [speechtranslationconfig]: /dotnet/api/microsoft.cognitiveservices.speech.speechtranslationconfig
 [audioconfig]: /dotnet/api/microsoft.cognitiveservices.speech.audio.audioconfig

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

@@ -293,9 +293,9 @@ For more information about speech synthesis, see [the basics of speech synthesis
 
 ## Multi-lingual translation with language identification
 
-In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-python#speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
+In many scenarios, you might not know which input languages to specify. Using [language identification](../../../language-identification.md?pivots=programming-language-python#run-speech-translation) you can detect up to 10 possible input languages and automatically translate to your target languages. 
 
-For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-python#speech-translation).
+For a complete code sample, see [language identification](../../../language-identification.md?pivots=programming-language-python#run-speech-translation).
 
 [speechtranslationconfig]: /python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.translation.speechtranslationconfig
 [audioconfig]: /python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.audio.audioconfig