Refactor documentation to be more discoverable and easier to get started (#881)

* Refactored all docs under single docs directory, split into: analytics, media, transcripts, skills, virtual-assistant. Resolved all URL refs

* Removed the "skills" or "virtualassistant-skills" prepend to current documents and updated related docs with new URLs.

* Cleaned up skills docs except for automotive

* Cleaned up READMEs so only root has the Contributing/License info and added a link to Analytics on root.

* Clean up the VA README

* Refactored detailedoverview to overview and consolidated with VA/READM
Refactored createvirtualassistant to gettingstarted

* Moved language support and updating virtual assistant content to main README.
Standardize skill to Skill usage.
Added table of contents formatting to linked accounts, personalization, responses docs.

* Updated formatting for remaining VA pages.

* Using writing style for readme

* Updating -> Deployment section and moved Personalization under Dive In

* Added blurb for unit testing to be developed as the toolkit grows.

* Updated skills readme with writing style

* Updated text on analytics and main readme

* Updated known issues and applied writing style guide to getting started overview

* Bold preview to italics per style guide

* Added links to bot services on main readme

* Update getting started link

* add proactivemodel deserialization issue into the known issues list

* Refactored all docs under single docs directory, split into: analytics, media, transcripts, skills, virtual-assistant. Resolved all URL refs

* Removed the "skills" or "virtualassistant-skills" prepend to current documents and updated related docs with new URLs.

* Cleaned up skills docs except for automotive

* Cleaned up READMEs so only root has the Contributing/License info and added a link to Analytics on root.

* Clean up the VA README

* Refactored detailedoverview to overview and consolidated with VA/READM
Refactored createvirtualassistant to gettingstarted

* Moved language support and updating virtual assistant content to main README.
Standardize skill to Skill usage.
Added table of contents formatting to linked accounts, personalization, responses docs.

* Updated formatting for remaining VA pages.

* Using writing style for readme

* Updating -> Deployment section and moved Personalization under Dive In

* Added blurb for unit testing to be developed as the toolkit grows.

* Updated skills readme with writing style

* Updated text on analytics and main readme

* Updated known issues and applied writing style guide to getting started overview

* Bold preview to italics per style guide

* Added links to bot services on main readme

* Update getting started link

* add proactivemodel deserialization issue into the known issues list

* Added powershell 6 prereq and csharp/typescript deployment

* Updated Skills README and added luis model generation doc to it

* Refactored skill enablement doc to Create a New Skill

* Added README for transcripts and renamed existing transcripts to use same filename formatting

Updated events doc and added links in productivity/poi skills where parameters are mentioned.

* Address Darren's PR comments

* Added email and todo sample transcripts to docs

* Added developing a new skill page

* Added code samples of development guide and refs on related READMEs

* Fix typo

* Remove OBI links
Add calendar transcript and remove skillsdemo transcript
Update linked accounts

* Removed transcript from old docs location

* Fixed capitalization

* added local mode deployment instructions

* highlight local mode deployment

* update to PoI skill invocation test

Author: ryanisgrig

README.md

@@ -1,20 +1,21 @@
-# Overview
+# Conversational AI Solutions
 
-This repository is the home for a set of templates and solutions to help build Conversational Experiences using Azure Bot Service and Bot Framework.
+This repository is the home for a set of templates and solutions to help build conversational experiences using [Azure Bot Service](https://aka.ms/azurebotservice) and [Bot Framework](https://botframework).
 
-# Templates
+## Templates
 
 Name | Description | Link
 ------------ | ------------- | :-----------:
-Enterprise Template | The creation of a high quality conversational experience requires a foundational set of capabilities. To help you succeed with building great conversational experiences, we have created an Enterprise Bot Template. <br /> <br />This template brings together all of the best practices and supporting components we've identified through building conversational experiences and greatly simplifies the creation of a new bot project including: basic conversational intents, Dispatcher integration, QnA Maker, Application Insights, Power BI insights and an automated deployment. | [Get Started](./templates/Enterprise-Template/README.md)
+Enterprise Template | A high quality conversational experience requires a foundational set of capabilities to maintain consistent quality. Install the Enterprise Bot Template for help in building a great experience with your users. <br /> <br />This template brings together all of the best practices and supporting components identified through building conversational experiences and greatly simplifies the creation of a new bot project including: basic conversational intents, Dispatch integration, QnA Maker, Application Insights and an automated deployment.| [Get Started](./templates/Enterprise-Template/README.md)
 
-# Solutions
+## Solutions
 
 Name | Description | Link 
 ------------ | ------------- | :-----------:
-Virtual Assistant | We have seen significant need from our customers and partners to deliver a conversational assistant tailored to their brand, personalized to their customers and made available across a broad range of conversational canvases and devices. <br /> <br /> Continuing Microsoft's open-source approach towards the Bot Framework SDK, the open source Virtual Assistant provides full control over the end user experience built on a set of foundational capabilities. Additionally, the experience can be infused with intelligence about the end-user and any device/ecosystem information for a truly integrated and intelligent experience.  | [Get Started](./solutions/Virtual-Assistant/docs/README.md)
+Virtual Assistant | Customers and partners have a significant need to deliver a conversational assistant tailored to their brand, personalized to their users, and made available across a broad range of canvases and devices. <br/><br/> Continuing Microsoft's open-sourced approach towards the Bot Framework SDK, the open-source Virtual Assistant solution provides you with a set of core foundational capabilities and full control over the end user experience.| [Get Started](./docs/virtual-assistant/README.md)
+Analytics | Gain key insights into your bot’s health and behavior with the Conversational AI Analytics solutions. Review available telemetry, sample Application Insights queries, and Power BI dashboards to understand the full breadth of your bot’s conversations with users. | [Get Started](./docs/analytics/README.md)
 
-# Contributing
+## Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
@@ -27,3 +28,6 @@ provided by the bot. You will only need to do this once across all repos using o
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+
+## License
+Copyright (c) Microsoft Corporation. All rights reserved.

solutions/analytics/README.md renamed to docs/analytics/README.md

@@ -14,7 +14,7 @@ insights across your organization. You can ingest data from Application Insights
 - [Power BI Analytics Sample](#power-bi-analytics-sample)
 
 ## Prerequisites
-The [Conversational Analytics Power BI sample](ConversationalAnalyticsSample_02132019.pbit) is generated 
+The [Conversational Analytics Power BI sample](https://aka.ms/botPowerBiTemplate) is generated 
 under the assumption you are using the latest Bot Framework SDK and telemetry middleware. You can find these (and generate the required Application Insights resource) with the following samples:
 
  - [Enterprise Template](https://github.com/Microsoft/AI/blob/master/templates/Enterprise-Template/README.md)
@@ -24,28 +24,27 @@ under the assumption you are using the latest Bot Framework SDK and telemetry mi
 
 ### Configuring Sentiment
 LUIS enables you to run a sentiment analysis on a user's utterance. This can be enabled through the [LUIS portal](https://www.luis.ai).
-Sentiment must be enabled for each application.  To enable sentiment:
+Sentiment must be enabled for each application. To enable sentiment:
 1. Log in to the portal.
 2. Select **My Apps**.
 3. Click on the specific application you want to enable sentiment.
 4. Select **Manage** on the upper menu.
 5. Select **Publish Settings** on the side menu. It should resemble the below.
 
-![Enabling Sentiment](media/enable_sentiment.png)
+![Enabling Sentiment](../media/enable_sentiment.png)
 
 6. **Enable** the *Use sentiment analysis to determine if a user's utterance is positive, negative, or neutral* checkbox.
 7. Select **Publish** and repeat for each LUIS application.
 
 ### Power BI Installation
 The [PowerBI Desktop client](https://aka.ms/pbidesktopstore) is available for Windows clients.
-Alternatively, you can use the Power BI service.  If you don't have a PowerBI service account, sign up for a [free 60 day trial account](https://app.powerbi.com/signupredirect?pbi_source=web) and upload the Power BI template to view the reports.
+Alternatively, you can use the Power BI service. If you don't have a PowerBI service account, sign up for a [free 60 day trial account](https://app.powerbi.com/signupredirect?pbi_source=web) and upload the Power BI template to view the reports.
 
 ## Telemetry Logging
-[Telemetry Overview](docs/analytics-telemetrylogging.md) highlights the provided telemetry for bot and user activities, including [LUIS](https://www.luis.ai/) and [QnA Maker](https://www.qnamaker.ai/) results.  how to configure your bot's telemetry, either through bot configuring or overriding the telemetry client.
+[Telemetry Overview](./telemetrylogging.md) highlights the provided telemetry for bot and user activities, including [LUIS](https://www.luis.ai/) and [QnA Maker](https://www.qnamaker.ai/) results. how to configure your bot's telemetry, either through bot configuring or overriding the telemetry client.
 
 ## Application Insights Analytics
-[Applications Insights Analytics](docs/analytics-applicationinsights.md) demonstrates how to execute common queries for for bot analytics and debugging in Visual Studio.
+Common queries for bot analytics are available in [Applications Insights Analytics](./applicationinsights.md).
 
 ## Power BI Analytics Sample
-
-The [Power BI Analytics sample](docs/analytics-powerbi.md) shows example Power BI dashboards to gain insights on your bot's performance and quality.
+Examples of Power BI dashboards are provided in the [Power BI Analytics sample](./powerbi.md), highlighting how to gain insights on your bot's performance and quality.

solutions/analytics/docs/analytics-applicationinsights.md renamed to docs/analytics/applicationinsights.md

@@ -3,7 +3,7 @@ The following provide some examples of retrieving data about your bot, to better
 
 ##  LUIS Intents Piechart
 
-The following demonstrates querying data that was generated by LUIS telemetry.  The telemetry logs the top intent from the recognizer (in addition to some other properties), and logs an [Application Insights Custom Event](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-api-custom-events-metrics).
+The following demonstrates querying data that was generated by LUIS telemetry. The telemetry logs the top intent from the recognizer (in addition to some other properties), and logs an [Application Insights Custom Event](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-api-custom-events-metrics).
 
 ![Luis Piechart](../media/luis_pie.png)
 ```
@@ -49,7 +49,7 @@ dependencies
 ```
 
 ## Using Application Insights in Visual Studio
-Within Visual Studio, Application Insights events can be queried in the "Application Insights Search" window.  [For more details, see the Application Insights documentation](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-diagnostic-search).
+Within Visual Studio, Application Insights events can be queried in the "Application Insights Search" window. [For more details, see the Application Insights documentation](https://docs.microsoft.com/en-us/azure/application-insights/app-insights-diagnostic-search).
 
 ![Example Visual Studio Session](../media/visualstudio_appinsights.png)
 

solutions/analytics/docs/analytics-powerbi.md renamed to docs/analytics/powerbi.md

@@ -1,5 +1,5 @@
 # Power BI
-The  [Conversational Analytics Power BI sample](../ConversationalAnalyticsSample_02132019.pbit) provides a PowerBI template that can be used to understand how your bot is performing.
+The  [Conversational Analytics Power BI sample](https://aka.ms/botPowerBiTemplate) provides a PowerBI template that can be used to understand how your bot is performing.
 
 ## Sample Overview
 |Dashboard Name|Description|