release 'live' 3-7-19 (#1340)

Author: ivorb

articles/bot-builder-deploy-az-cli.md

@@ -50,6 +50,7 @@ After creating the target Web App Bot, you need to download the bot code from th
 1. In the **Bot Management** section, click **Build**.
 1. Click on **Download Bot source code** link in the right-pane.
 1. Follow the prompts to download the code, and then unzip the folder.
+	1. [!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
 
 ### Decrypt the .bot file
 
@@ -197,6 +198,8 @@ If you are using an [MSA](https://en.wikipedia.org/wiki/Microsoft_account) email
 Next, download the bot you just created. 
 [!INCLUDE [download bot snippet](~/includes/deploy/snippet-download-bot.md)]
 
+[!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
+
 ### Decrypt the downloaded .bot file and use in your project
 
 The sensitive information in the .bot file is encrypted.

articles/bot-service-change-hosting-plan.md

@@ -28,6 +28,7 @@ Follow these steps to download the source code of your existing bot:
 
 1. Within your Azure bot, click the **Settings** tab and expand the **Continuous deployment** section.  
 2. Click the blue button to download the zip file that contains the source code for your bot.  
+	1. [!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
     ![Download the bot zip file](~/media/continuous-deployment-consumption-download.png)
 3. Extract the contents of the downloaded zip file to a local folder. 
 

articles/bot-service-continuous-deployment.md

@@ -29,6 +29,7 @@ If you have not configured continuous deployment, you can modify your source fil
 To set up publishing from Visual Studio using the `.PublishSettings` file, perform the following steps:
 
 1. In the Azure Portal, click your Bot Service, click the **BUILD** tab, and click **Download zip file**.
+	1. [!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
 3. Extract the contents of the downloaded zip file to a local folder.
 4. In Explorer, find the Visual Studio Solution (.sln) file for your bot, and double-click it.
 4. In Visual Studio, click **View**, and click **Solution Explorer**.
@@ -62,6 +63,7 @@ This section describes how to enable continuous deployment for a bot that you cr
 Follow these steps if you want to use a source control service *other than* Visual Studio Online or Github. Visual Studio Online and Github will pull the source code for your bot from Azure, so users of those two services can skip these steps.
 
 3. For a bot on an App Service plan, find your bot page on Azure, click the **BUILD** tab, find the **Download source code** section, and click **Download zip file**.
+	1. [!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
 1. Create an empty repository within one of the source control systems that Azure supports.
 
     ![Source control system](~/media/continuous-integration-sourcecontrolsystem.png)

articles/bot-service-quickstart.md

@@ -128,6 +128,7 @@ You can download the code to work on it locally.
 1. In the **Bot Management** section, click **Build**. 
 1. Click on **Download Bot source code** link in the right-pane. 
 1. Follow the prompts to download the code, and then unzip the folder.
+    1. [!INCLUDE [download keys snippet](~/includes/snippet-abs-key-download.md)]
 
 The code you downloaded uses an encrypted [.bot file](./v4sdk/bot-file-basics.md). You'll need to update `botFilePath` and `botFileSecret` entires in the appsettings.json or .env file. 
 To do that, go to the Azure portal. Select your bot in the portal, then under **App Service Settings** section, click **Application Settings**. In the **Application Settings** pane, you'll 

articles/includes/snippet-abs-key-download.md

@@ -0,0 +1 @@
+When downloading your bot, you will be given the option to include the settings (containing the keys and secrets) for your bot in your download, which may be necessary for your bot to work. If you choose **Yes**, the `appsettings.json` or `.env` file will have the keys.

articles/media/azure-bot-quickstarts/abs-keys-download.png

@@ -1,10 +1,7 @@
 # Enterprise template
-## [Introduction](../v4sdk/bot-builder-enterprise-template-overview.md)
-## [Overview](../v4sdk/bot-builder-enterprise-template-overview-detail.md)
-## [Create a project](../v4sdk/bot-builder-enterprise-template-create-project.md)
+## [Overview](../v4sdk/bot-builder-enterprise-template-overview.md)
+## [Get Started](../v4sdk/bot-builder-enterprise-template-getting-started.md)
 ## [Customize template](../v4sdk/bot-builder-enterprise-template-customize.md)
-## [Deploy template](../v4sdk/bot-builder-enterprise-template-deployment.md)
-## [Analytics](../v4sdk/bot-builder-enterprise-template-powerbi.md)
 # Virtual Assistant 
 ## [Overview](../v4sdk/bot-builder-virtual-assistant-introduction.md)
 # [FAQ](../bot-service-resources-bot-framework-faq.md)

articles/resources/TOC.md

@@ -14,8 +14,7 @@ monikerRange: 'azure-bot-service-4.0'
 > [!NOTE]
 > This topic applies to v4 version of the SDK. 
 
-## .NET
-After you have deployed and tested that the Enterprise Bot Template works end-to-end as listed in the instructions [here](bot-builder-enterprise-template-deployment.md),
+After you have deployed and tested that the Enterprise Bot Template works end-to-end as listed in the instructions [here](bot-builder-enterprise-template-getting-started.md),
 you can easily customize your bot based on your scenario and needs. The goal of the template is to provide a solid foundation upon which to build your conversational experience.
 
 ## Project Structure
@@ -76,56 +75,56 @@ There are two Cognitive Models included with the Enterprise Template by default,
 To update an existing LUIS model for the Enterprise Template, perform these steps:
 1. Make your changes to the LUIS Model in the [LUIS Portal](http://luis.ai) or using the [LuDown](https://github.com/Microsoft/botbuilder-tools/tree/master/packages/Ludown) and [Luis](https://github.com/Microsoft/botbuilder-tools/tree/master/packages/LUIS) CLI tools. 
 2. Run the following command to update your Dispatch model to reflect your changes (ensures proper message routing):
-```shell
+    ```shell
     dispatch refresh --bot "YOUR_BOT.bot" --secret YOUR_SECRET
-```
+    ```
 3. Run the following command from your project root for each updated model to update their associated LuisGen classes: 
-```shell
+    ```shell
     luis export version --appId [LUIS_APP_ID] --versionId [LUIS_APP_VERSION] --authoringKey [YOUR_LUIS_AUTHORING_KEY] | luisgen --cs [CS_FILE_NAME] -o "\Dialogs\Shared\Resources"
-```
+    ```
 
 ### Updating an existing QnA Maker knowledge base
 To update an existing QnA Maker knowledge base, perform the following steps:
 1. Make changes to your QnA Maker knowledge base via the [LuDown](https://github.com/Microsoft/botbuilder-tools/tree/master/packages/Ludown) and [QnA Maker](https://github.com/Microsoft/botbuilder-tools/tree/master/packages/QnAMaker) CLI tools or the [QnA Maker Portal](https://qnamaker.ai).
 2. Run the following command to update your Dispatch model to reflect your changes (ensures proper message routing):
-```shell
+    ```shell
     dispatch refresh --bot "YOUR_BOT.bot" --secret YOUR_SECRET
-```
+    ```
 
 ### Adding a new LUIS model
 
 In scenarios where you wish to add a new LUIS model to your project you need to update the Bot configuration and Dispatcher to ensure it is aware of the additional model. 
 1. Create your LUIS model through LuDown/LUIS CLI tools or through the LUIS portal
 2. Run the following command to connect your new LUIS app to your .bot file:
-```shell
+    ```shell
     msbot connect luis --appId [LUIS_APP_ID] --authoringKey [LUIS_AUTHORING_KEY] --subscriptionKey [LUIS_SUBSCRIPTION_KEY] 
-```
+    ```
 3. Add this new LUIS model to your Dispatcher through the following command
-```shell
+    ```shell
     dispatch add -t luis -id LUIS_APP_ID -bot "YOUR_BOT.bot" --secret YOURSECRET
-```
+    ```
 4. Refresh the dispatch model to reflect the LUIS model changes through the following command
-```shell
+    ```shell
     dispatch refresh -bot "YOUR_BOT.bot" --secret YOUR_SECRET
-```
+    ```
 
 ### Adding an additional QnA Maker knowledge base
 
 In some scenarios you may wish to add an addditional QnA Maker knowledge base to your Bot, this can be performed through the following steps.
 
 1. Create a new QnA Maker knowledge base from a JSON file using the following command executed in your assistant directory
-```shell
-qnamaker create kb --in <KB.json> --msbot | msbot connect qna --stdin --bot "YOUR_BOT.bot" --secret YOURSECRET
-```
+    ```shell
+    qnamaker create kb --in <KB.json> --msbot | msbot connect qna --stdin --bot "YOUR_BOT.bot" --secret YOURSECRET
+    ```
 2. Run the following command to update your Dispatch model to reflect your changes
-```shell
-dispatch refresh --bot "YOUR_BOT.bot" --secret YOUR_SECRET
-```
+    ```shell
+    dispatch refresh --bot "YOUR_BOT.bot" --secret YOUR_SECRET
+    ```
 3. Update the strongly typed Dispatch class to reflect the new QnA source
-```shell
-msbot get dispatch --bot "YOUR_BOT.bot" | luis export version --stdin > dispatch.json
-luisgen dispatch.json -cs Dispatch -o Dialogs\Shared
-```
+    ```shell
+    msbot get dispatch --bot "YOUR_BOT.bot" | luis export version --stdin > dispatch.json
+    luisgen dispatch.json -cs Dispatch -o Dialogs\Shared
+    ```
 4.  Update the `Dialogs\Main\MainDialog.cs` file to include the corresponding Dispatch intent for your new QnA source following the example provided.
 
 You should now be able to leverage multiple QnA sources as part of your Bot.
@@ -198,6 +197,3 @@ await _responder.ReplyWith(sc.Context, OnboardingResponses.ResponseIds.HaveNameM
 The final piece of Dialog infrastruture is the creation of a State class scoped to your Dialog only. Create a new class and ensure it derives from `DialogState`
 
 Once your dialog is complete, your need to add the dialog to your `MainDialog` component using `AddDialog`. To use your new Dialog, call `dc.BeginDialogAsync()` from within your `RouteAsync` method, triggering with the appropriate LUIS intent if desired.
-
-## Conversational insights using PowerBI dashboard and Application Insights
-- To get started with getting Conversational insights, continue with  [Configure conversational analytics with PowerBI dashboard](bot-builder-enterprise-template-powerbi.md).