Merge pull request #249664 from MicrosoftDocs/main

8/29/2023 AM Publish

Author: Taojunshen

articles/active-directory/saas-apps/g-suite-provisioning-tutorial.md

@@ -107,45 +107,46 @@ This section guides you through the steps to configure the Azure AD provisioning
 
 ### To configure automatic user provisioning for G Suite in Azure AD:
 
-1. Sign in to the [Azure portal](https://portal.azure.com). Select **Enterprise Applications**, then select **All applications**. Users will need to log in to `portal.azure.com` and won't be able to use `aad.portal.azure.com`.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. Browse to **Azure Active Directory** > **Enterprise Applications** > **All applications**.
 
 	![Enterprise applications blade](./media/g-suite-provisioning-tutorial/enterprise-applications.png)
 
 	![All applications blade](./media/g-suite-provisioning-tutorial/all-applications.png)
 
-2. In the applications list, select **G Suite**.
+1. In the applications list, select **G Suite**.
 
 	![The G Suite link in the Applications list](common/all-applications.png)
 
-3. Select the **Provisioning** tab. Click on **Get started**.
+1. Select the **Provisioning** tab. Click on **Get started**.
 
 	![Screenshot of the Manage options with the Provisioning option called out.](common/provisioning.png)
 
       ![Get started blade](./media/g-suite-provisioning-tutorial/get-started.png)
 
-4. Set the **Provisioning Mode** to **Automatic**.
+1. Set the **Provisioning Mode** to **Automatic**.
 
 	![Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.](common/provisioning-automatic.png)
 
-5. Under the **Admin Credentials** section, click on **Authorize**. You'll be redirected to a Google authorization dialog box in a new browser window.
+1. Under the **Admin Credentials** section, click on **Authorize**. You'll be redirected to a Google authorization dialog box in a new browser window.
 
       ![G Suite authorize](./media/g-suite-provisioning-tutorial/authorize-1.png)
 
-6. Confirm that you want to give Azure AD permissions to make changes to your G Suite tenant. Select **Accept**.
+1. Confirm that you want to give Azure AD permissions to make changes to your G Suite tenant. Select **Accept**.
 
      ![G Suite Tenant Auth](./media/g-suite-provisioning-tutorial/gapps-auth.png)
 
-7. In the Azure portal, click **Test Connection** to ensure Azure AD can connect to G Suite. If the connection fails, ensure your G Suite account has Admin permissions and try again. Then try the **Authorize** step again.
+1. In the Azure portal, click **Test Connection** to ensure Azure AD can connect to G Suite. If the connection fails, ensure your G Suite account has Admin permissions and try again. Then try the **Authorize** step again.
 
-6. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and select the **Send an email notification when a failure occurs** check box.
+1. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and select the **Send an email notification when a failure occurs** check box.
 
 	![Notification Email](common/provisioning-notification-email.png)
 
-7. Select **Save**.
+1. Select **Save**.
 
-8. Under the **Mappings** section, select **Provision Azure Active Directory Users**.
+1. Under the **Mappings** section, select **Provision Azure Active Directory Users**.
 
-9. Review the user attributes that are synchronized from Azure AD to G Suite in the **Attribute-Mapping** section. Select the **Save** button to commit any changes.
+1. Review the user attributes that are synchronized from Azure AD to G Suite in the **Attribute-Mapping** section. Select the **Save** button to commit any changes.
 
 > [!NOTE]
 > GSuite Provisioning currently only supports the use of primaryEmail as the matching attribute. 
@@ -225,9 +226,9 @@ This section guides you through the steps to configure the Azure AD provisioning
    |websites.[type eq "work"].value|String|
 
 
-10. Under the **Mappings** section, select **Provision Azure Active Directory Groups**.
+1. Under the **Mappings** section, select **Provision Azure Active Directory Groups**.
 
-11. Review the group attributes that are synchronized from Azure AD to G Suite in the **Attribute-Mapping** section. The attributes selected as **Matching** properties are used to match the groups in G Suite for update operations. Select the **Save** button to commit any changes.
+1. Review the group attributes that are synchronized from Azure AD to G Suite in the **Attribute-Mapping** section. The attributes selected as **Matching** properties are used to match the groups in G Suite for update operations. Select the **Save** button to commit any changes.
 
       |Attribute|Type|
       |---|---|
@@ -236,17 +237,17 @@ This section guides you through the steps to configure the Azure AD provisioning
       |name|String|
       |description|String|
 
-12. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
+1. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
 
-13. To enable the Azure AD provisioning service for G Suite, change the **Provisioning Status** to **On** in the **Settings** section.
+1. To enable the Azure AD provisioning service for G Suite, change the **Provisioning Status** to **On** in the **Settings** section.
 
 	![Provisioning Status Toggled On](common/provisioning-toggle-on.png)
 
-14. Define the users and/or groups that you would like to provision to G Suite by choosing the desired values in **Scope** in the **Settings** section.
+1. Define the users and/or groups that you would like to provision to G Suite by choosing the desired values in **Scope** in the **Settings** section.
 
 	![Provisioning Scope](common/provisioning-scope.png)
 
-15. When you're ready to provision, click **Save**.
+1. When you're ready to provision, click **Save**.
 
 	![Saving Provisioning Configuration](common/provisioning-configuration-save.png)
 

articles/ai-services/qnamaker/How-To/add-sharepoint-datasources.md

@@ -111,7 +111,8 @@ The Active Directory manager will get a pop-up window requesting permissions to
 -->
 ### Grant access from the Azure Active Directory admin center
 
-1. The Active Directory manager signs in to the Azure portal and opens **[Enterprise applications](https://aad.portal.azure.com/#blade/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/AllApps)**.
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. Browse to **Azure Active Directory** > **Enterprise applications**.
 
 1. Search for `QnAMakerPortalSharePoint` the select the QnA Maker app.
 

articles/ai-services/speech-service/get-started-speech-to-text.md

@@ -1,14 +1,14 @@
 ---
 title: "Speech to text quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, you convert speech to text with recognition from a microphone.
+description: In this quickstart, learn how to convert speech to text with recognition from a microphone or .wav file.
 services: cognitive-services
 author: eric-urban
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: quickstart
-ms.date: 09/16/2022
+ms.date: 08/24/2023
 ms.author: eur
 ms.devlang: cpp, csharp, golang, java, javascript, objective-c, python
 ms.custom: devx-track-python, devx-track-js, devx-track-csharp, cog-serv-seo-aug-2020, mode-other, devx-track-extended-java, devx-track-go

articles/ai-services/speech-service/get-started-text-to-speech.md

@@ -1,14 +1,14 @@
 ---
 title: "Text to speech quickstart - Speech service"
 titleSuffix: Azure AI services
-description: In this quickstart, you convert text to speech. Learn about object construction and design patterns, supported audio output formats, and custom configuration options for speech synthesis.
+description: In this quickstart, you convert text to speech. Learn about object construction and design patterns, supported audio formats, and custom configuration options.
 services: cognitive-services
 author: eric-urban
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: quickstart
-ms.date: 09/16/2022
+ms.date: 08/25/2023
 ms.author: eur
 ms.devlang: cpp, csharp, golang, java, javascript, objective-c, python
 ms.custom: devx-track-python, devx-track-js, devx-track-csharp, cog-serv-seo-aug-2020, mode-other, devx-track-extended-java, devx-track-go

articles/ai-services/speech-service/includes/common/azure-prerequisites.md

@@ -2,12 +2,12 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
-ms.date: 06/30/2022
+ms.date: 08/24/2023
 ms.topic: include
 ms.author: eur
 ---
 
 > [!div class="checklist"]
-> * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
-> * <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Create a Speech resource</a> in the Azure portal.
-> * Get the Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. For more information about Azure AI services resources, see [Get the keys for your resource](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource). 
+> - Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services).
+> - <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices"  title="Create a Speech resource"  target="_blank">Create a Speech resource</a> in the Azure portal.
+> - Your Speech resource key and region. After your Speech resource is deployed, select **Go to resource** to view and manage keys. For more information about Azure AI services resources, see [Get the keys for your resource](~/articles/ai-services/multi-service-resource.md?pivots=azportal#get-the-keys-for-your-resource). 

articles/ai-services/speech-service/includes/common/delete-resource.md

@@ -3,7 +3,7 @@ author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 01/25/2022
+ms.date: 08/24/2023
 ms.author: eur
 ---
 

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

@@ -3,18 +3,19 @@ author: eric-urban
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 09/14/2022
+ms.date: 08/24/2023
 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 that runs 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 such as [Azure Key Vault](../../../use-key-vault.md).
 
-To set the environment variable for your Speech resource key, 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 `SPEECH_REGION` environment variable, replace `your-region` with one of the regions for your resource.
+To set the environment variable for your Speech resource key, 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 `SPEECH_REGION` environment variable, replace *your-region* with one of the regions for your resource.
 
 #### [Windows](#tab/windows)
 
@@ -24,9 +25,9 @@ setx SPEECH_REGION your-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 variables in the current console, you can 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 programs that need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before you run the example.
 
 #### [Linux](#tab/linux)
 
@@ -41,7 +42,7 @@ After you add the environment variables, run `source ~/.bashrc` from your consol
 
 ##### Bash
 
-Edit your .bash_profile, and add the environment variables:
+Edit your *.bash_profile* file, and add the environment variables:
 
 ```bash
 export SPEECH_KEY=your-key
@@ -54,12 +55,12 @@ After you add the environment variables, run `source ~/.bash_profile` from your
 
 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.
 
-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**.
 
 To set the environment variable for your Speech resource region, follow the same steps. Set `SPEECH_REGION` to the region of your resource. For example, `westus`.
 
-For more configuration options, see the [Xcode documentation](https://help.apple.com/xcode/#/dev745c5c974).
+For more configuration options, see [the Xcode documentation](https://help.apple.com/xcode/#/dev745c5c974).
 ***

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

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 02/12/2022
+ms.date: 08/24/2023
 ms.author: eur
 ---
 
@@ -18,59 +18,77 @@ ms.author: eur
 
 ## Recognize speech from a microphone
 
-Run the following command to start speech recognition from a microphone:
+1. Run the following command to start speech recognition from a microphone:
 
-```console
-spx recognize --microphone --source en-US
-```
+   ```console
+   spx recognize --microphone --source en-US
+   ```
 
-Speak into the microphone, and you see transcription of your words into text in real-time. The Speech CLI stops after a period of silence, 30 seconds, or when you press Ctrl+C.
+1. Speak into the microphone, and you see transcription of your words into text in real-time. The Speech CLI stops after a period of silence, 30 seconds, or when you select **Ctrl**+**C**.
 
-```console
-Connection CONNECTED...
-RECOGNIZED: I'm excited to try speech to text.
-```
+   ```output
+   Connection CONNECTED...
+   RECOGNIZED: I'm excited to try speech to text.
+   ```
 
 ## Remarks
-Now that you've completed the quickstart, here are some additional considerations:
+
+Here are some other considerations:
 
 - To recognize speech from an audio file, use `--file` instead of `--microphone`. For compressed audio files such as MP4, install GStreamer and use `--format`. For more information, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md).
+
     # [Terminal](#tab/terminal)
+
     ```console
     spx recognize --file YourAudioFile.wav
     spx recognize --file YourAudioFile.mp4 --format any
     ```
+
     # [PowerShell](#tab/powershell)
+
     ```powershell
     spx recognize --file YourAudioFile.wav
     spx --% recognize --file YourAudioFile.mp4 --format any
     ```
+
     ***
+
 - To improve recognition accuracy of specific words or utterances, use a [phrase list](~/articles/ai-services/speech-service/improve-accuracy-phrase-list.md). You include a phrase list in-line or with a text file along with the recognize command:
+
     # [Terminal](#tab/terminal)
+
     ```console
     spx recognize --microphone --phrases "Contoso;Jessie;Rehaan;"
     spx recognize --microphone --phrases @phrases.txt
     ```
+
     # [PowerShell](#tab/powershell)
+
     ```powershell
     spx --% recognize --microphone --phrases "Contoso;Jessie;Rehaan;"
     spx --% recognize --microphone --phrases @phrases.txt
+
     ```
+
     ***
-- To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md). For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language.
+
+- 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`.
+
     ```console
     spx recognize --microphone --source es-ES
     ```
+
 - For continuous recognition of audio longer than 30 seconds, append `--continuous`:
+
     ```console
     spx recognize --microphone --source es-ES --continuous
     ```
 
-Run this command for information about additional speech recognition options such as file input and output:
-```console
-spx help recognize
-```
+- Run this command for information about more speech recognition options such as file input and output:
+
+    ```console
+    spx help recognize
+    ```
 
 ## Clean up resources