zxyanliu/grammar pass 2/4 (#2536)

* grammar check1/12 * Update bot-builder-howto-bf-cli-deploy-qna.md * update grammar check * Update bot-service-resources-user-agent.md * Update articles/bot-service-channel-connect-slack.md Co-authored-by: Michael Miele <[email protected]> Co-authored-by: Michael Miele <[email protected]> Co-authored-by: Jonathan Fingold <[email protected]>
MicrosoftDocs · openpublishbuild · Nov 24, 2020 · Nov 24, 2020 · Nov 25, 2020 · Nov 25, 2020
commit e523d1da9fc2545d538b1ddcd20f322cdedd1f7f
diff --git a/articles/bot-service-channel-connect-directline.md b/articles/bot-service-channel-connect-directline.md
@@ -17,7 +17,6 @@ This article describes how to connect a bot to the **Direct Line channel**. Use
 > NOTE
 > The Direct Line is a standard channel over HTTPS protocol to allow communication between a client application and a bot. If you require network isolation instead, use the [Direct Line App Service Extension](bot-service-channel-directline-extension.md) over [WebSocket protocol](https://tools.ietf.org/html/rfc6455).
 
-
 ## Add the Direct Line channel
 
 The first thing you must do is to add the Direct Line channel to the bot.
@@ -110,7 +109,7 @@ The example contains two projects:
     </appSettings>
     ```
 
-User messages are sent to the Bot using the Direct Line Client `Conversations.PostActivityAsync` method using the `ConversationId` generated previously.
+User messages are sent to the bot using the Direct Line Client `Conversations.PostActivityAsync` method using the `ConversationId` generated previously.
 
 ```csharp
 while (true)

diff --git a/articles/bot-service-channel-connect-slack.md b/articles/bot-service-channel-connect-slack.md
@@ -29,7 +29,7 @@ This article shows how to add a Slack channel to a bot. Select one of the follow
     ![Set up bot](~/media/channels/slack-NewApp.png)
 
 1. Click **Create New App**.
-1. In the **App Name** box, enter the name of your Slack application
+1. In the **App Name** box, enter the name of your Slack application.
 1. In the **Development Slack Team** box, enter the name of your development team. If you are not already a member of a Development Slack Team, [create or join one](https://slack.com/).
 
     ![Create app](~/media/channels/slack-CreateApp.png)
@@ -93,7 +93,7 @@ If your bot will use Slack-specific functionality such as buttons, follow these
 ### Add the Slack channel to the bot
 
 1. In the left panel, select the **Basic Information** item.
-1. In the right panel, scroll to the **App Credentials** section. The **Client ID**, **Client Secret**, and **Signing Secrte** required for configuring your Slack bot channel are displayed. Copy and store these credentials in safe place.
+1. In the right panel, scroll to the **App Credentials** section. The **Client ID**, **Client Secret**, and **Signing Secret** required for configuring your Slack bot channel are displayed. Copy and store these credentials in safe place.
 
     ![Gather credentials](~/media/channels/slack-AppCredentials.png)
 
@@ -130,16 +130,16 @@ Authorized users can click the **Add to Slack** button provided by this modified
 
 ### Connect a bot to Slack using the Slack adapter
 
-As well as the channel available in the Azure Bot Service to connect your bot with Slack, you can also use the Slack adapter. In this article you will learn how to connect a bot to Slack using the adapter.  This article will walk you through modifying the EchoBot sample to connect it to a Slack app.
+As well as the channel available in the Azure Bot Service to connect your bot with Slack, you can also use the Slack adapter. In this article you will learn how to connect a bot to Slack using the adapter. This article will walk you through modifying the EchoBot sample to connect it to a Slack app.
 
 > [!NOTE]
 > The instructions below cover the C# implementation of the Slack adapter. For instructions on using the JS adapter, part of the BotKit libraries, [see the BotKit Slack documentation](https://botkit.ai/docs/v4/platforms/slack.html).
 
 ### Prerequisites
 
-* The [EchoBot sample code](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/csharp_dotnetcore/02.echo-bot)
+- The [EchoBot sample code](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/csharp_dotnetcore/02.echo-bot)
 
-* Access to a Slack workspace with sufficient permissions to create and manage applications at  [https://api.slack.com/apps](https://api.slack.com/apps). If you do not have access to a Slack environment you can create a workspace for [free](https://www.slack.com).
+- Access to a Slack workspace with sufficient permissions to create and manage applications at  [https://api.slack.com/apps](https://api.slack.com/apps). If you do not have access to a Slack environment you can create a workspace for [free](https://www.slack.com).
 
 ### Create a Slack application and configure it for your bot
 
@@ -201,7 +201,7 @@ public class SlackAdapterWithErrorHandler : SlackAdapter
 
 #### Create a new controller for handling Slack requests
 
-We create a new controller which will handle requests from your slack app, on a new endpoing 'api/slack' instead of the default 'api/messages' used for requests from Azure Bot Service Channels.  By adding an additional endpoint to your bot, you can accept requests from Bot Service channels, as well as from Slack, using the same bot.
+We create a new controller which will handle requests from your slack app, on a new endpoint `api/slack` instead of the default `api/messages` used for requests from Azure Bot Service Channels.  By adding an additional endpoint to your bot, you can accept requests from Bot Service channels, as well as from Slack, using the same bot.
 
 ```csharp
 [Route("api/slack")]
@@ -246,7 +246,7 @@ Add the following line to the ***ConfigureServices*** method within your startup
 services.AddSingleton<SlackAdapter, SlackAdapterWithErrorHandler>();
 ```
 
-Once added, your ***ConfigureServices*** method shold look like this.
+Once added, your ***ConfigureServices*** method should look like this.
 
 ```csharp
 public void ConfigureServices(IServiceCollection services)
@@ -303,7 +303,7 @@ Navigate back to the [Slack API dashboard](https://api.slack.com/apps) and selec
 
 1. Log in the Slack work space where you installed your app (`http://<your work space>-group.slack.com/`). You will see it listed under the **Apps** section in the left panel.
 1. In the left panel, select your app.
-1. In the right panel, wite e message and send it to the application. If you used an echo bot, the application echoes back the message as shown in the figure below.
+1. In the right panel, write e message and send it to the application. If you used an echo bot, the application echoes back the message as shown in the figure below.
 
     ![app testing](~/media/channels/slack-echobotapp-test.png)
 

diff --git a/articles/bot-service-channel-directline.md b/articles/bot-service-channel-directline.md
@@ -12,9 +12,9 @@ ms.date: 10/05/2020
 ---
 
 # About Direct Line
-[!INCLUDE [applies-to-v4](includes/applies-to-v4-current.md)]
-The Bot Framework offers multiple channels with the Direct Line branding. It is important that you select the version that best fits the conversational A.I. experience you are designing.
 
+[!INCLUDE [applies-to-v4](includes/applies-to-v4-current.md)]
+The Bot Framework offers multiple channels with the Direct Line branding. It is important that you select the version that best fits the conversational AI experience you are designing.
 
 - **Direct Line**. This is the standard channel offering of Direct Line. It works by default with bot templates via the [Azure portal](https://ms.portal.azure.com/), bots from the [Bot Builder Samples](https://github.com/Microsoft/BotBuilder-Samples/blob/main/README.md), and bots created with the [Azure CLI](https://docs.microsoft.com/cli/azure/what-is-azure-cli). This is the Direct Line best suited in the majority of the cases. See [Connect a bot to Direct Line](bot-service-channel-connect-directline.md).
 - **Direct Line Speech**. It provides text to speech and speech to text services within the channel. It allows a client to stream audio directly to the channel which will then be converted to text and sent to the bot. The Direct Line Speech is also able to convert text messages from the bot into audio messages as spoken by a variety of A.I. powered voices. Combined, this makes Direct Line Speech capable of having audio only conversations with clients. See [Connect a bot to Direct Line Speech](bot-service-channel-connect-directlinespeech.md).
@@ -23,13 +23,13 @@ The Bot Framework offers multiple channels with the Direct Line branding. It is
 You can choose which offering of Direct Line is best for you by evaluating the features each offers and the needs of your solution.
 Over time these offerings will be simplified.
 
-| Feature                    | Direct Line | Direct Line App Service Extension | Direct Line Speech |
-|----------------------------|-------------|-----------------------------------|--------------------|
-| Availability and Licensing    | GA | GA  | GA |
+| Feature      | Direct Line | Direct Line App Service Extension | Direct Line Speech |
+|--------------|-------------|-----------------------------------|--------------------|
+| Availability and Licensing | GA | GA  | GA |
 | Speech recognition and text-to-speech performance | Standard | Standard | High performance |
 | Supports legacy web browsers | Yes | Yes | Yes |
 | Bot Framework SDK support | All v3, v4 | v4.63+ required | v4.63+ required |
-| Client SDK support    | JS, C# | JS, C# | C++, C#, Unity, JS|
+| Client SDK support | JS, C# | JS, C# | C++, C#, Unity, JS|
 | Works with Web Chat  | Yes | Yes | Yes |
 | VNET | No | Yes | No |
 

diff --git a/articles/bot-service-manage-analytics.md b/articles/bot-service-manage-analytics.md
@@ -111,4 +111,5 @@ To find this value, open Application Insights and navigate to **Configure** > **
 For more information on how to locate these values, see [Application Insights keys](~/bot-service-resources-app-insights-keys.md).
 
 ## Additional resources
+
 * [Application Insights keys](~/bot-service-resources-app-insights-keys.md)
diff --git a/articles/bot-service-resources-user-agent.md b/articles/bot-service-resources-user-agent.md
@@ -17,7 +17,7 @@ If you're reading this message, you may have received a request from a Microsoft
 
 If you received a request from our service, it likely had a User-Agent header formatted similar to the string below:
 
-```User-Agent: BF-DirectLine/3.0 (Microsoft-BotFramework/3.0 +https://botframework.com/ua)```
+`User-Agent: BF-DirectLine/3.0 (Microsoft-BotFramework/3.0 +https://botframework.com/ua)`
 
 The most important part of this string is the **Microsoft-BotFramework** identifier, which is used by the Microsoft Bot Framework, a collection of tools and services that allows independent software developers to create and operate their own bots.
 

diff --git a/articles/v4sdk/bot-builder-concept-authentication-types.md b/articles/v4sdk/bot-builder-concept-authentication-types.md
@@ -42,16 +42,16 @@ When you register a bot in the Azure portal, for example via the **Bot Channels
 
 When a channel sends a request to a bot, via the Bot Connector service, it specifies a **token** in the **Authorization header** of the request. The bot authenticates calls from the Bot Connector service by verifying the authenticity of the token.
 
-
 When the bot sends a request to a channel via the **Bot Connector service**, it must specify the **token** in the **Authorization header** of the request.
 All requests must include the access token which is verified by the Bot Connector service to authorize the request.
 
 The operations described are automatically performed by the Bot Framework SDK.
 
 For more details, see the REST API documentation on how to [authenticate requests from the Bot Connector service to your bot](~/rest-api/bot-framework-rest-connector-authentication.md#connector-to-bot) and [authenticate requests from your bot to the Bot Connector service](~/rest-api/bot-framework-rest-connector-authentication.md#bot-to-connector).
+
 ### Channels
 
-Typically, channels communicate with a bot via the **Bot Connector service** this means that the previous authentication principles generally apply. You may want to notice characteristics of specific channels.
+Typically, channels communicate with a bot via the **Bot Connector service**. This means that the previous authentication principles generally apply. You may want to notice characteristics of specific channels.
 
 #### Direct Line
 
@@ -62,10 +62,8 @@ The client application authenticates requests to Direct Line (version 3.0) eithe
 > [!IMPORTANT]
 > When you use Azure Bot Service authentication with Web Chat there are some important security considerations you must keep in mind. For more information, see the [security considerations](~/bot-service-channel-connect-webchat.md#keep-your-secret-hidden-exchange-your-secret-for-a-token-and-generate-the-embed) section in the REST authentication article.
 
-
 For more information, see [Keep your secret hidden, exchange your secret for a token, and generate the embed](~/bot-service-channel-connect-webchat.md#keep-your-secret-hidden-exchange-your-secret-for-a-token-and-generate-the-embed).
 
-
 #### Web Chat
 
 The Web Chat has two implementations: the **channel** and the **control**.

diff --git a/articles/v4sdk/bot-builder-howto-bf-cli-deploy-qna.md b/articles/v4sdk/bot-builder-howto-bf-cli-deploy-qna.md
@@ -30,14 +30,25 @@ The Bot Framework Command Line Interface (CLI) lets you automate the management
 
 This article describes how to perform some common tasks used to deploy a QnA Maker KB using the Bot Framework CLI.
 
-1. [Create your QnA Maker resource in Azure Cognitive Services](#create-your-qna-maker-resource-in-azure-cognitive-services)
-1. [Install the Bot Framework CLI](#install-the-bot-framework-cli)
-1. [Create your QnA Maker initialization file](#create-your-qna-maker-initialization-file)
-1. [Create your QnA Maker model](#create-your-qna-maker-model)
-1. [Create your QnA Maker knowledge base](#create-your-qna-maker-knowledge-base)
-1. [Test your QnA Maker knowledge base](#test-your-qna-maker-knowledge-base)
-1. [Publish your QnA Maker knowledge base](#publish-your-qna-maker-knowledge-base)
-1. [Create a QnA Maker knowledge base and publish it to production using the build command](#create-a-qna-maker-knowledge-base-and-publish-it-to-production-using-the-build-command)
+- [Deploy QnA Maker knowledge base using the Bot Framework qnamaker CLI commands](#deploy-qna-maker-knowledge-base-using-the-bot-framework-qnamaker-cli-commands)
+  - [Prerequisites](#prerequisites)
+  - [Using the qnamaker CLI commands to enable QnA Maker in your bot](#using-the-qnamaker-cli-commands-to-enable-qna-maker-in-your-bot)
+  - [Create your QnA Maker resource in Azure Cognitive Services](#create-your-qna-maker-resource-in-azure-cognitive-services)
+  - [Install the Bot Framework CLI](#install-the-bot-framework-cli)
+  - [Create your QnA Maker initialization file](#create-your-qna-maker-initialization-file)
+  - [Create your QnA Maker model](#create-your-qna-maker-model)
+  - [Create your QnA Maker knowledge base](#create-your-qna-maker-knowledge-base)
+  - [Test your QnA Maker knowledge base](#test-your-qna-maker-knowledge-base)
+  - [Publish your QnA Maker knowledge base](#publish-your-qna-maker-knowledge-base)
+  - [Create a QnA Maker knowledge base and publish it to production using the build command](#create-a-qna-maker-knowledge-base-and-publish-it-to-production-using-the-build-command)
+    - [How to use the build command](#how-to-use-the-build-command)
+      - [The qnamaker:build parameters](#the-qnamakerbuild-parameters)
+      - [The qnamaker configuration file](#the-qnamaker-configuration-file)
+    - [QnA and multiple language variations](#qna-and-multiple-language-variations)
+    - [QnA Maker Knowledge Bases created](#qna-maker-knowledge-bases-created)
+    - [The settings file generated using the build command](#the-settings-file-generated-using-the-build-command)
+    - [The dialog file](#the-dialog-file)
+  - [Additional information](#additional-information)
 
 Once your bot project's QnA Maker KB .qna files have been created, you are ready to follow the steps outlined in this article to create your QnA Maker KB. If you do not have a project with QnA Maker KB .qna files, you can use the [QnAMaker][qna-maker-sample]. See the sample repository's readme for information on [Getting the samples][getting-the-samples].
 
@@ -244,7 +255,7 @@ The pattern for the .qna file name when language variants are used is as follows
 
 For example:
 
-```
+```qna
 example.en-us.qna
 example.fr-fr.qna
 example.de-de.qna
@@ -267,7 +278,7 @@ The QnA Maker KB name:
 
 For example, if your botName is _MyProject_ and your username is _YuuriTanaka_, the names of your KBs would be as follows:
 
-```
+```qna
 MyProject(YuuriTanaka).en-us.qna
 MyProject(YuuriTanaka).fr-fr.qna
 MyProject(YuuriTanaka).de-de.qna
Original file line number	Diff line number	Diff line change
Expand Up		@@ -111,4 +111,5 @@ To find this value, open Application Insights and navigate to Configure > **
		For more information on how to locate these values, see [Application Insights keys](~/bot-service-resources-app-insights-keys.md).

		## Additional resources

		* [Application Insights keys](~/bot-service-resources-app-insights-keys.md)