docs: improve clarity, consistency, and tone in speech quickstart

Author: Qi Ding

articles/ai-services/speech-service/includes/common/environment-variables-resourcekey-endpoint.md

@@ -1,4 +1,4 @@
-<!-- --- -->
+---
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
@@ -13,13 +13,13 @@ You need to authenticate your application to access Azure AI services. This arti
 To set the environment variables for your Speech resource key and region, open a console window, and follow the instructions for your operating system and development environment.
 
 - To set the `SPEECH_KEY` environment variable, replace *your-key* with one of the keys for your resource.
-- To set the `END_POINT` environment variable, replace *your-end-point* with one of the regions for your resource.
+- To set the `ENDPOINT` environment variable, replace *your-endpoint* with one of the regions for your resource.
 
 #### [Windows](#tab/windows)
 
 ```console
 setx SPEECH_KEY your-key
-setx END_POINT your-end-point
+setx ENDPOINT your-endpoint
 ```
 
 > [!NOTE]
@@ -35,7 +35,7 @@ Edit your *.bashrc* file, and add the environment variables:
 
 ```bash
 export SPEECH_KEY=your-key
-export END_POINT=your-end-point
+export ENDPOINT=your-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bashrc` from your console window to make the changes effective.
@@ -48,7 +48,7 @@ Edit your *.bash_profile* file, and add the environment variables:
 
 ```bash
 export SPEECH_KEY=your-key
-export END_POINT=your-end-point
+export ENDPOINT=your-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bash_profile` from your console window to make the changes effective.
@@ -62,7 +62,7 @@ For iOS and macOS development, you set the environment variables in Xcode. For e
 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**.
 
-To set the environment variable for your Speech resource region, follow the same steps. Set `END_POINT` to the endpoint of your resource. For example, `https://YourServiceRegion.api.cognitive.microsoft.com`.
+To set the environment variable for your Speech resource region, follow the same steps. Set `ENDPOINT` to the endpoint of your resource. For example, `https://YourServiceRegion.api.cognitive.microsoft.com`.
 
 
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/cpp.md

@@ -51,16 +51,16 @@ Follow these steps to create a console application and install the Speech SDK.
     
    int main()
    {
-       // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+       // This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
        auto speechKey = GetEnvironmentVariable("SPEECH_KEY");
-       auto endPoint = GetEnvironmentVariable("END_POINT");
+       auto endpoint = GetEnvironmentVariable("ENDPOINT");
         
-       if ((size(speechKey) == 0) || (size(endPoint) == 0)) {
-           std::cout << "Please set both SPEECH_KEY and END_POINT environment variables." << std::endl;
+       if ((size(speechKey) == 0) || (size(endpoint) == 0)) {
+           std::cout << "Please set both SPEECH_KEY and ENDPOINT environment variables." << std::endl;
            return -1;
        }
     
-       auto speechConfig = SpeechConfig::FromEndpoint(speechKey, endPoint);
+       auto speechConfig = SpeechConfig::FromEndpoint(speechKey, endpoint);
     
        speechConfig->SetSpeechRecognitionLanguage("en-US");
     
@@ -113,10 +113,10 @@ Follow these steps to create a console application and install the Speech SDK.
 
 1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, use `es-ES` for Spanish (Spain). If you don't specify a language, the default is `en-US`. For details about how to identify one of multiple languages that might be spoken, see [Language identification](~/articles/ai-services/speech-service/language-identification.md).
 
-1. [Build and run](/cpp/build/vscpp-step-2-build) your new console application to start speech recognition from a microphone.
+1. To start speech recognition from a microphone, [Build and run](/cpp/build/vscpp-step-2-build) your new console application.
 
    > [!IMPORTANT]
-   > Make sure that you set the `SPEECH_KEY` and `END_POINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
+   > Make sure that you set the `SPEECH_KEY` and `ENDPOINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 1. Speak into your microphone when prompted. What you speak should appear as text:
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/csharp.md

@@ -54,9 +54,9 @@ Follow these steps to create a console application and install the Speech SDK.
 
    class Program 
    {
-       // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+       // This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
        static string speechKey = Environment.GetEnvironmentVariable("SPEECH_KEY");
-       static string endPoint = Environment.GetEnvironmentVariable("END_POINT");
+       static string endpoint = Environment.GetEnvironmentVariable("ENDPOINT");
 
        static void OutputSpeechRecognitionResult(SpeechRecognitionResult speechRecognitionResult)
        {
@@ -84,7 +84,7 @@ Follow these steps to create a console application and install the Speech SDK.
 
        async static Task Main(string[] args)
        {
-           var speechConfig = SpeechConfig.FromEndpoint(speechKey, endPoint);
+           var speechConfig = SpeechConfig.FromEndpoint(speechKey, endpoint);
            speechConfig.SpeechRecognitionLanguage = "en-US";
 
            using var audioConfig = AudioConfig.FromDefaultMicrophoneInput();
@@ -106,7 +106,7 @@ Follow these steps to create a console application and install the Speech SDK.
    ```
 
    > [!IMPORTANT]
-   > Make sure that you set the `SPEECH_KEY` and `END_POINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
+   > Make sure that you set the `SPEECH_KEY` and `ENDPOINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 1. Speak into your microphone when prompted. What you speak should appear as text:
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/java.md

@@ -75,12 +75,12 @@ Follow these steps to create a console application for speech recognition.
    import java.util.concurrent.Future;
 
    public class SpeechRecognition {
-       // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+       // This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
        private static String speechKey = System.getenv("SPEECH_KEY");
-       private static String endPoint = System.getenv("END_POINT");
+       private static String endpoint = System.getenv("ENDPOINT");
 
        public static void main(String[] args) throws InterruptedException, ExecutionException {
-           SpeechConfig speechConfig = SpeechConfig.fromEndpoint(speechKey, endPoint);
+           SpeechConfig speechConfig = SpeechConfig.fromEndpoint(speechKey, endpoint);
            speechConfig.setSpeechRecognitionLanguage("en-US");
            recognizeFromMicrophone(speechConfig);
        }
@@ -125,7 +125,7 @@ Follow these steps to create a console application for speech recognition.
    ```
 
    > [!IMPORTANT]
-   > Make sure that you set the `SPEECH_KEY` and `END_POINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
+   > Make sure that you set the `SPEECH_KEY` and `ENDPOINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 1. Speak into your microphone when prompted. What you speak should appear as text:
 

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/python.md

@@ -49,9 +49,9 @@ Follow these steps to create a console application.
    import azure.cognitiveservices.speech as speechsdk
 
    def recognize_from_microphone():
-        # This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+        # This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
         # Replace with your own subscription key and endpoint, the endpoint is like : "https://YourServiceRegion.api.cognitive.microsoft.com"
-       speech_config = speechsdk.SpeechConfig(subscription=os.environ.get('SPEECH_KEY'), endpoint=os.environ.get('END_POINT'))
+       speech_config = speechsdk.SpeechConfig(subscription=os.environ.get('SPEECH_KEY'), endpoint=os.environ.get('ENDPOINT'))
        speech_config.speech_recognition_language="en-US"
 
        audio_config = speechsdk.audio.AudioConfig(use_default_microphone=True)
@@ -83,7 +83,7 @@ Follow these steps to create a console application.
    ```
 
    > [!IMPORTANT]
-   > Make sure that you set the `SPEECH_KEY` and `END_POINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
+   > Make sure that you set the `SPEECH_KEY` and `ENDPOINT` [environment variables](#set-environment-variables). If you don't set these variables, the sample fails with an error message.
 
 1. Speak into your microphone when prompted. What you speak should appear as text:
 

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

@@ -47,9 +47,9 @@ Follow these steps to create a new console application and install the Speech SD
     {
         // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
         auto speechKey = GetEnvironmentVariable("SPEECH_KEY");
-        auto endPoint = GetEnvironmentVariable("END_POINT");
+        auto endpoint = GetEnvironmentVariable("END_POINT");
 
-        auto speechTranslationConfig = SpeechTranslationConfig::FromEndpoint(speechKey, endPoint);
+        auto speechTranslationConfig = SpeechTranslationConfig::FromEndpoint(speechKey, endpoint);
         speechTranslationConfig->SetSpeechRecognitionLanguage("en-US");
         speechTranslationConfig->AddTargetLanguage("it");
     
@@ -107,9 +107,9 @@ Follow these steps to create a new console application and install the Speech SD
     ```
 
 1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=stt#supported-languages). Specify the full locale with a dash (`-`) separator. For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md). 
-1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
+1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions, you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
 
-[Build and run](/cpp/build/vscpp-step-2-build) your new console application to start speech recognition from a microphone.
+To start speech recognition from a microphone, [Build and run](/cpp/build/vscpp-step-2-build) your new console application.
 
 Speak into your microphone when prompted. What you speak should be output as translated text in the target language: 
 
@@ -120,7 +120,7 @@ Translated into 'it': Sono entusiasta di provare la traduzione vocale.
 ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
+After completing the quickstart, here are some more considerations:
 
 - This example uses the `RecognizeOnceAsync` operation to transcribe utterances of up to 30 seconds, or until silence is detected. For information about continuous recognition for longer audio, including multi-lingual conversations, see [How to translate speech](~/articles/ai-services/speech-service/how-to-translate-speech.md). 
 - To recognize speech from an audio file, use `FromWavFileInput` instead of `FromDefaultMicrophoneInput`:

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/csharp.md

@@ -45,9 +45,9 @@ Follow these steps to create a new console application and install the Speech SD
     
     class Program 
     {
-        // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+        // This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
         static string speechKey = Environment.GetEnvironmentVariable("SPEECH_KEY");
-        static string endPoint = Environment.GetEnvironmentVariable("END_POINT");
+        static string endpoint = Environment.GetEnvironmentVariable("ENDPOINT");
     
         static void OutputSpeechRecognitionResult(TranslationRecognitionResult translationRecognitionResult)
         {
@@ -79,7 +79,7 @@ Follow these steps to create a new console application and install the Speech SD
     
         async static Task Main(string[] args)
         {
-            var speechTranslationConfig = SpeechTranslationConfig.FromEndpoint(speechKey, endPoint);       
+            var speechTranslationConfig = SpeechTranslationConfig.FromEndpoint(speechKey, endpoint);       
             speechTranslationConfig.SpeechRecognitionLanguage = "en-US";
             speechTranslationConfig.AddTargetLanguage("it");
     
@@ -94,7 +94,7 @@ Follow these steps to create a new console application and install the Speech SD
     ```
 
 1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=stt#supported-languages). Specify the full locale with a dash (`-`) separator. For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md).
-1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
+1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions, you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
 
 Run your new console application to start speech recognition from a microphone:
 
@@ -111,7 +111,7 @@ TRANSLATED into 'it': Sono entusiasta di provare la traduzione vocale.
 ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
+After completing the quickstart, here are some more considerations:
 
 - This example uses the `RecognizeOnceAsync` operation to transcribe utterances of up to 30 seconds, or until silence is detected. For information about continuous recognition for longer audio, including multi-lingual conversations, see [How to translate speech](~/articles/ai-services/speech-service/how-to-translate-speech.md).
 - To recognize speech from an audio file, use `FromWavFileInput` instead of `FromDefaultMicrophoneInput`:

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/java.md

@@ -74,12 +74,12 @@ Follow these steps to create a new console application for speech recognition.
     import java.util.Map;
 
     public class SpeechTranslation {
-        // This example requires environment variables named "SPEECH_KEY" and "END_POINT"
+        // This example requires environment variables named "SPEECH_KEY" and "ENDPOINT"
         private static String speechKey = System.getenv("SPEECH_KEY");
-        private static String endPoint = System.getenv("END_POINT");
+        private static String endpoint = System.getenv("ENDPOINT");
 
         public static void main(String[] args) throws InterruptedException, ExecutionException {
-            SpeechTranslationConfig speechTranslationConfig = SpeechTranslationConfig.fromEndpoint(speechKey, endPoint);
+            SpeechTranslationConfig speechTranslationConfig = SpeechTranslationConfig.fromEndpoint(speechKey, endpoint);
             speechTranslationConfig.setSpeechRecognitionLanguage("en-US");
 
             String[] toLanguages = { "it" };
@@ -124,7 +124,7 @@ Follow these steps to create a new console application for speech recognition.
     ```
 
 1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=stt#supported-languages). Specify the full locale with a dash (`-`) separator. For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md). 
-1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
+1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions, you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
 
 Run your new console application to start speech recognition from a microphone:
 
@@ -142,7 +142,7 @@ Translated into 'it': Sono entusiasta di provare la traduzione vocale.
 ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
+After completing the quickstart, here are some more considerations:
 
 - This example uses the `RecognizeOnceAsync` operation to transcribe utterances of up to 30 seconds, or until silence is detected. For information about continuous recognition for longer audio, including multi-lingual conversations, see [How to translate speech](~/articles/ai-services/speech-service/how-to-translate-speech.md).
 - To recognize speech from an audio file, use `fromWavFileInput` instead of `fromDefaultMicrophoneInput`: