Release 'live' 12-14-17

Author: Kamran Iqbal

articles/TOC.md

@@ -18,7 +18,7 @@
 ### [Commerce bot](bot-service-scenario-commerce.md)
 ### [Cortana Skill bot](bot-service-scenario-cortana-skill.md)
 ### [Enterprise Productivity bot](bot-service-scenario-enterprise-productivity.md)
-### [Informational bot](bot-service-scenario-informational.md)
+### [Information bot](bot-service-scenario-informational.md)
 ### [Internet of Things bot](bot-service-scenario-internet-things.md)
 # How-To guides
 ## [Design](design/TOC.md)

articles/bot-builder-overview-getstarted.md

@@ -39,7 +39,7 @@ Download Visual Studio project templates to accelerate bot development.
 * [Cortana skill template for Visual Studio][cortana-template] for developing Cortana skills with C#
 
 > [!TIP]
-> <a href="https://docs.microsoft.com/en-us/visualstudio/ide/how-to-locate-and-organize-project-and-item-templates" target="_blank">Learn more</a> about how to install Visual Studio 2017 project templates.
+> <a href="/visualstudio/ide/how-to-locate-and-organize-project-and-item-templates" target="_blank">Learn more</a> about how to install Visual Studio 2017 project templates.
 
 ## Bot Builder SDK for Node.js
 The Bot Builder SDK for Node.js provides a familiar way for Node.js developers to write bots. You can use it to build a wide variety of conversational user interfaces, from simple prompts to free-form conversations. The Bot Builder SDK for Node.js uses restify, a popular framework for building web services, to create the bot's web server. The SDK is also compatible with Express. 

articles/bot-builder-reference-overview.md

@@ -12,7 +12,7 @@ ms.date: 12/13/2017
 The Bot Framework includes comprehensive reference documentation for the Bot Builder SDK for .NET, the Bot Builder SDK for Node.js, and the Bot Framework REST APIs.
 
 ## Bot Builder SDK for .NET
-To learn about the structure of the Bot Builder SDK for .NET, see the [Bot Builder SDK for .NET reference documentation](https://docs.microsoft.com/en-us/dotnet/api/).
+To learn about the structure of the Bot Builder SDK for .NET, see the [Bot Builder SDK for .NET reference documentation](/dotnet/api/).
 
 You can also explore the Bot Builder SDK for .NET [source code](https://github.com/Microsoft/BotBuilder/tree/master/CSharp) on GitHub. 
 

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

@@ -18,7 +18,7 @@ Bots on an App Service plan run as Azure web apps. Web app bots can do things th
 
 - A web app bot can add custom route definitions.
 - A web app bot can enable a Websocket server. 
-- A bot that uses a Consumption hosting plan has the same limitations as all code running on Azure Functions. For more information, see <a target='_blank' href='https://docs.microsoft.com/en-us/azure/azure-functions/functions-scale'>Azure Functions Consumption and App Service plans</a>.
+- A bot that uses a Consumption hosting plan has the same limitations as all code running on Azure Functions. For more information, see <a target='_blank' href='/azure/azure-functions/functions-scale'>Azure Functions Consumption and App Service plans</a>.
 
 ## Download your existing bot source
 

articles/bot-service-debug-cortana-skill.md

@@ -126,7 +126,7 @@ Once you have tested your Cortana skill and verified that it works the way you'd
 * [Testing and debugging best practices][Cortana-TestBestPractice]
 * [Preview features with the Channel Inspector](bot-service-channel-inspector.md)
 
-[CortanaGetStarted]: https://docs.microsoft.com/en-us/cortana/getstarted
+[CortanaGetStarted]: /cortana/getstarted
 
 [BFPortal]: https://dev.botframework.com/
 [CortanaDevCenter]: https://developer.microsoft.com/en-us/cortana
@@ -139,7 +139,7 @@ Once you have tested your Cortana skill and verified that it works the way you'd
 
 [Cortana-Debug]: https://aka.ms/cortana-enable-debug
 [Cortana-TestBestPractice]: https://aka.ms/cortana-test-best-practice
-[Cortana-Publish]: https://docs.microsoft.com/en-us/cortana/skills/publish-skill
+[Cortana-Publish]: /cortana/skills/publish-skill
 
 
 

articles/bot-service-debug-emulator.md

@@ -70,7 +70,7 @@ Ensure that [ngrok](#ngrok) is installed and that the emulator's App Settings sp
 Finally, click **Connect** to connect the emulator to your bot. After the emulator has connected to your bot, you can send and receive messages using the embedded chat control.
 
 ## Enable speech recognition
-The Bot Framework Emulator supports speech recognition via the [Cognitive Services Speech API](https://docs.microsoft.com/en-us/azure/cognitive-services/Speech/home). This allows you to exercise your speech-enabled bot, or Cortana skill, via speech in the emulator during development. The Bot Framework Emulator provides speech recognition free of charge for up to three hours per bot per day. 
+The Bot Framework Emulator supports speech recognition via the [Cognitive Services Speech API](/azure/cognitive-services/Speech/home). This allows you to exercise your speech-enabled bot, or Cortana skill, via speech in the emulator during development. The Bot Framework Emulator provides speech recognition free of charge for up to three hours per bot per day. 
 
 ## Send system activities
 

articles/bot-service-manage-analytics.md

@@ -10,12 +10,12 @@ ms.date: 12/13/2017
 
 ---
 # Bot analytics
-Analytics is an extension of [Application Insights](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-analytics). Application Insights provides **service-level** and instrumentation data like traffic, latency, and integrations. Analytics provides **conversation-level** reporting on user, message, and channel data.
+Analytics is an extension of [Application Insights](/azure/application-insights/app-insights-analytics). Application Insights provides **service-level** and instrumentation data like traffic, latency, and integrations. Analytics provides **conversation-level** reporting on user, message, and channel data.
 
 ## View analytics for a bot
 To access Analytics, open the bot in the developer portal and click **Analytics**.
 
-Too much data? [Enable and configure sampling](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-sampling) to reduce telemetry traffic and storage while maintaining statistically correct analysis. 
+Too much data? [Enable and configure sampling](/azure/application-insights/app-insights-sampling) to reduce telemetry traffic and storage while maintaining statistically correct analysis. 
 
 ### Specify channel
 Choose which channels appear in the graphs below. Note that if a bot is not enabled on a channel, there will be no data from that channel.
@@ -66,10 +66,10 @@ The Message graph tracks how many messages were sent and received using which ch
 ## Enable analytics
 Analytics are not available until Application Insights has been enabled and configured. Application Insights will begin collecting data as soon as it is enabled. For example, if Application Insights was enabled a week ago for a six-month-old bot, it will have collected one week of data.
 > [!NOTE]
-> Analytics requires both an Azure subscription and Application Insights [resource](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-create-new-resource).
+> Analytics requires both an Azure subscription and Application Insights [resource](/azure/application-insights/app-insights-create-new-resource).
 To access Application Insights, open the bot in the [Bot Framework Portal](https://dev.botframework.com/) and click **Settings**.
 
-1. Create an Application Insights [resource](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-create-new-resource).
+1. Create an Application Insights [resource](/azure/application-insights/app-insights-create-new-resource).
 2. Open the bot in the dashboard. Click **Settings** and scroll down to the **Analytics** section.
 3. Enter the information to connect the bot to Application Insights. All fields are required.
 

articles/bot-service-overview-readme.md

@@ -29,7 +29,7 @@ A bot that uses an App Service plan is a standard Azure web app you can set to a
 * Use sample code prepared for the Bot Builder SDK.
 
 ### Consumption plan
-A bot that uses a Consumption plan is a serverless bot that runs on <a href="http://go.microsoft.com/fwlink/?linkID=747839" target="_blank">Azure Functions</a>, and uses the pay-per-run Azure Functions pricing. A bot that uses this hosting plan can scale to handle huge traffic spikes. You can edit bot source code online using a basic in-browser code editor. For more information about the runtime environment of a Consumption plan bot, see <a target='_blank' href='https://docs.microsoft.com/en-us/azure/azure-functions/functions-scale'>Azure Functions Consumption and App Service plans</a>.
+A bot that uses a Consumption plan is a serverless bot that runs on <a href="http://go.microsoft.com/fwlink/?linkID=747839" target="_blank">Azure Functions</a>, and uses the pay-per-run Azure Functions pricing. A bot that uses this hosting plan can scale to handle huge traffic spikes. You can edit bot source code online using a basic in-browser code editor. For more information about the runtime environment of a Consumption plan bot, see <a target='_blank' href='/azure/azure-functions/functions-scale'>Azure Functions Consumption and App Service plans</a>.
 
 ## Templates
 

articles/bot-service-quickstart.md

@@ -30,14 +30,14 @@ Log in to the [Azure portal](http://portal.azure.com).
  | ---- | ---- | ---- |
  | **Bot name** | Your bot's display name | The display name for the bot that appears in channels and directories. This name can be changed at anytime. |
  | **Subscription** | Your subscription | Select the Azure subscription you want to use. |
- | **Resource Group** | myResourceGroup | You can create a new [resource group](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview#resource-groups) or choose from an existing one. |
+ | **Resource Group** | myResourceGroup | You can create a new [resource group](/azure/azure-resource-manager/resource-group-overview#resource-groups) or choose from an existing one. |
  | **Location** | The default location | Select the geographic location for your resource group. Your location choice can be any location listed, though it's often best to choose a location closest to your customer. The location cannot be changed once the bot is created. |
  | **Pricing tier** | F0 | Select a pricing tier. You may update the pricing tier at any time. For more information, see [Bot Service pricing](https://azure.microsoft.com/en-us/pricing/details/bot-service/). |
  | **App name** | A unique name | The unique URL name of the bot. For example, if you name your bot *myawesomebot*, then your bot's URL will be `http://myawesomebot.azurewebsites.net`. The name must use alphanumeric and underscore characters only. There is a 35 character limit to this field. The App name cannot be changed once the bot is created. |
  | **Bot template** | Basic | Choose either **C#** or **Node.js** and select the **Basic** template for this quickstart, then click **Select**. The Basic template creates an echo bot. [Learn more](bot-service-concept-templates.md) about the templates. |
  | **App service plan/Location** | Your app service plan  | Select an [app service plan](https://azure.microsoft.com/en-us/pricing/details/app-service/plans/) location. Your location choice can be any location listed, though it's often best to choose a location closest to your customer. (Not available for Functions Bot.) |
- | **Azure Storage** | Your Azure storage account | You can create a new data storage account or use an existing one. By default, the bot will use [Table Storage](https://docs.microsoft.com/en-us/azure/storage/common/storage-introduction#table-storage). |
- | **Application Insights** | On | Decide if you want to turn [Application Insights](https://docs.microsoft.com/en-us/bot-framework/bot-service-manage-analytics) **On** or **Off**. If you select **On**, you must also specify a regional location. Your location choice can be any location listed, though it's often best to choose a location closest to your customer. |
+ | **Azure Storage** | Your Azure storage account | You can create a new data storage account or use an existing one. By default, the bot will use [Table Storage](/azure/storage/common/storage-introduction#table-storage). |
+ | **Application Insights** | On | Decide if you want to turn [Application Insights](/bot-framework/bot-service-manage-analytics) **On** or **Off**. If you select **On**, you must also specify a regional location. Your location choice can be any location listed, though it's often best to choose a location closest to your customer. |
 
  > [!NOTE]
  > 

articles/bot-service-scenario-commerce.md

@@ -11,16 +11,16 @@ ms.date: 12/13/2017
 # Commerce bot scenario
 The [Commerce bot](bot-service-scenario-commerce.md) scenario describes a bot that replaces the traditional e-mail and phone call interactions that people typically have with a hotel's concierge service. The bot takes advantage of Cognitive Services to better process customer requests via text and voice with context gathered from integration with backend services.
 
-![The application bot diagram](~/media/scenarios/bot-service-scenario-application-bot.png)
+![The application bot diagram](~/media/scenarios/bot-service-scenario-commerce-bot.png)
 
 Here is the logic flow of a Commerce bot that functions as a concierge for a hotel:
 
 1. The customer uses the hotel mobile app.
-2. The customer is authenticated via an Azure Active Directory v2 authentication endpoint.
-3. The bot looks up the customer's reservations and provides different service options based on the customer status level. For example, the customer might need dinner reservations or to book a cabana by the pool. 
-4. The bot integrates with the Language Understanding (LUIS) to better understand customer requests.
-5. The customer reviews the response and refines their question using natural conversation.
-6. After the customer accepts the response, the bot updates the customer's reservation.
+2. Using Azure AD B2C, the user authenticates.
+3. Using the custom Application Bot, user requests information. 
+4. Cognitive Services helps process the natural language request.
+5. Response is reviewed by customer who can refine the question using natural conversation.
+6. After the user is happy with the results, the Application Bot updates the customer’s reservation.
 7. Application insights gathers runtime telemetery to help development with bot performance and usage.
 
 ## Sample bot