Fix git push error for protected CLA branch

articles/bot-service-channel-connect-directlinespeech.md

@@ -17,7 +17,7 @@ ms.author: travisw
 
 You can configure your bot to allow client applications to communicate with it through the Direct Line Speech channel.
 
-Once you have built your bot, onboarding it with Direct Line Speech will enable low latency, high reliability connection with client applications using the [Speech SDK](https://aka.ms/speech/sdk). These connections are optimized for voice in, voice out conversational experiences. For more information on Direct Line Speech and how to build client applications, visit the [custom voice-first virtual assistant](https://aka.ms/bots/speech/va) page. 
+Once you have built your bot, onboarding it with Direct Line Speech will enable low latency, high reliability connection with client applications using the [Speech SDK](https://aka.ms/speech/sdk). These connections are optimized for voice in, voice out conversational experiences. For more information on Direct Line Speech and how to build client applications, visit the [custom voice-first virtual assistant](https://aka.ms/bots/speech/va) page.
 
 ## Add the Direct Line Speech channel
 
@@ -29,9 +29,20 @@ Once you have built your bot, onboarding it with Direct Line Speech will enable
 
     ![selecting direct line speech channel](media/voice-first-virtual-assistants/bot-service-channel-directlinespeech-connectspeechchannel.png "connecting Direct Line Speech")
 
-1. Direct Line Speech Channel requires a Cognitive Services resource. You can either use an existing resource or create a new Cognitive Services resource following the [instructions](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account). 
+1. Configure the Direct Line Speech as shown in the picture below.
 
-    ![selecting direct line speech channel](media/voice-first-virtual-assistants/bot-service-channel-directlinespeech-cognitivesericesaccount-selection.png "selecting Cogntive Services resource")
+    ![selecting direct line speech channel](media/voice-first-virtual-assistants/bot-service-channel-directlinespeech-cognitivesericesaccount-selection.png "selecting Cognitive Services resource")
+
+    The Direct Line Speech Channel requires a Cognitive Services resource, specifically a **speech** cognitive service resource. You can either use an existing resource or create a new one. To create a new speech resource follow these steps:
+
+    - Go to the [Azure portal create resources](https://ms.portal.azure.com/#create/hub).
+    - Search for *Speech* and select it from the drop-down list. The following is displayed:
+
+        ![create speech cognitive resource](media/voice-first-virtual-assistants/create-speech-cognitive-resource.PNG "Create speech cognitive resource")
+
+    - Follow the wizard steps.
+
+    For additional information, see [Create a Cognitive Services resource](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account).
 
 1. Once you've reviewed the terms of use, click `Save` to confirm your channel selection.
 
@@ -41,7 +52,7 @@ Once you have built your bot, onboarding it with Direct Line Speech will enable
 
 With the Direct Line Speech channel connected to your bot, you now need to enable Bot Framework Protocol Streaming Extensions support for optimal, low-latency interaction.
 
-1. If you haven't already, open the blade for your bot in the [Azure Portal](https://portal.azure.com). 
+1. If you haven't already, open the blade for your bot in the [Azure Portal](https://portal.azure.com).
 
 1. Click on **Settings** under the **Bot Management** category (right below **Channels**). Click the checkbox for **Enable Streaming Endpoint**.
 

articles/bot-service-channel-connect-slack.md

@@ -19,42 +19,53 @@ There are two ways in which you can confgure Slack messaging app:
 ## [Azure Bot Service Portal](#tab/abs)
 ## Create a Slack application for your bot
 
-Log into [Slack](https://slack.com/signin) and then go to [create a Slack application](https://api.slack.com/apps) channel.
+1. In your browser, log into [Slack](https://slack.com/signin).
+1. Navigate to [create a Slack application](https://api.slack.com/apps) channel.
 
 ![Set up bot](~/media/channels/slack-NewApp.png)
 
 ## Create an app and assign a Development Slack team
 
-Enter an App Name and select a Development Slack Team. If you are not already a member of a Development Slack Team, [create or join one](https://slack.com/).
+1. Click the **Create New App** button.
+1. Enter an App Name and select a Development Slack 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)
 
-Click **Create App**. Slack will create your app and generate a Client ID and Client Secret.
+1. Click the **Create App** button. Slack will create your app and generate a **Client ID** and **Client Secret**.
 
 ## Add a new Redirect URL
 
-Next you will add a new Redirect URL.
-
-1. Select the **OAuth & Permissions** tab.
-2. Click **Add a new Redirect URL**.
-3. Enter [https://slack.botframework.com](https://slack.botframework.com).
-4. Click **Add**.
-5. Click **Save URLs**.
+1. In the left panel, click the **OAuth & Permissions** link.
+2. In the right panel, click the **Add a new Redirect URL** button.
+3. Enter the following value `https://slack.botframework.com`.
+4. Click the **Add** button.
+5. Click the **Save URLs** button.
 
 ![Add Redirect URL](~/media/channels/slack-RedirectURL.png)
 
-## Create a Slack Bot User
+## Add bot token scopes
+<!-- Replaces add user -->
+1. In the left panel, click the **OAuth & Permissions** link.
+1. In the right panel, scroll down to **Scopes**.
+1. In the **Bot Token Scopes** section, click the **Add an OAuth Scope** button.
+1. Make sure to select the following scopes, also shown in the picture:
 
-Adding a Bot User allows you to assign a username for your bot and choose whether it is always shown as online.
+    - `app_mentions:read`
+    - `channels:history`
+    - `channels:read`
+    - `chat:write`
+    - `groups:history`
+    - `groups:read`
+    - `im:history`
+    - `mpim:history`
 
-1. Select the **Bot Users** tab.
-2. Click **Add a Bot User**.
+    ![slack bot scopes](media/channels/slack-bot-scopes.PNG)
 
-![Create bot](~/media/channels/slack-CreateBot.png)
+1. In the left panel select the **App Home** link.
+1. In the right panel, scroll down and enable **Always Show My Bot as Online**.
 
-Click **Add Bot User** to validate your settings, click **Always Show My Bot as Online** to **On**, and then click **Save Changes**.
-
-![Create bot](~/media/channels/slack-CreateApp-AddBotUser.png)
+    ![slack bot display](media/channels/slack-bot-display.PNG)
 
 ## Subscribe to Bot Events
 
@@ -73,12 +84,13 @@ Follow these steps to subscribe to six particular bot events. By subscribing to
 
 4. In **Subscribe to Bot Events**, click **Add Bot User Event**.
 5. In the list of events, select these six event types:
-    * `member_joined_channel`
-    * `member_left_channel`
-    * `message.channels`
-    * `message.groups`
-    * `message.im`
-    * `message.mpim`
+
+    - `member_joined_channel`
+    - `member_left_channel`
+    - `message.channels`
+    - `message.groups`
+    - `message.im`
+    - `message.mpim`
 
    ![Subscribe Events: middle](~/media/channels/slack-SubscribeEvents-b.png)
 
@@ -281,10 +293,10 @@ Now that you have created a Slack app and wired up the adapter in your bot proje
 To complete this step, [deploy your bot to Azure](https://aka.ms/bot-builder-deploy-az-cli) and make a note of the URL to your deployed bot.
 
 > [!NOTE]
-> If you are not ready to deploy your bot to Azure, or wish to debug your bot when using the Slack adapter, you can use a tool such as [ngrok](https://www.ngrok.com) (which you will likely already have installed if you have used the Bot Framework emulator previously) to tunnel through to your bot running locally and provide you with a publicly accessible URL for this. 
-> 
+> If you are not ready to deploy your bot to Azure, or wish to debug your bot when using the Slack adapter, you can use a tool such as [ngrok](https://www.ngrok.com) (which you will likely already have installed if you have used the Bot Framework emulator previously) to tunnel through to your bot running locally and provide you with a publicly accessible URL for this.
+>
 > If you wish create an ngrok tunnel and obtain a URL to your bot, use the following command in a terminal window (this assumes your local bot is running on port 3978, alter the port numbers in the command if your bot is not).
-> 
+>
 > ```
 > ngrok.exe http 3978 -host-header="localhost:3978"
 > ```

articles/bot-service-channel-directline-extension-webchat-client.md

@@ -24,7 +24,7 @@ https://github.com/Jeffders/DirectLineAppServiceExtensionPreview/tree/master/lib
 
 ## Integrate WebChat client
 
-Generally speaking, the approach is the same as before. With the exception that a new version of **WebChat** has been created that supports two-way **WebSocket** traffic, which instead of connecting to https://directline.botframework.com/ connects directly to your hosted bot.
+Generally speaking, the approach is the same as before. With the exception that a new version of **WebChat** has been created that supports two-way **WebSocket** traffic, which instead of connecting to [https://directline.botframework.com/](https://directline.botframework.com/) connects directly to your hosted bot.
 The direct line URL for your bot will be `https://<your_app_service>.azurewebsites.net/.bot/`, where the `/.bot/` extension is the Direct Line **endpoint** on your App Service.
 If you can configure your own domain name you still must append the `/.bot/` path to access the direct line REST APIs.