[Docs][Master]fix proactive notifications and new line in code block (#2885)

* [Docs]fix proactive notifications and new line in code block leads to error

* fix more links via html-proofer

Author: xieofxie

docs/_docs/help/faq.md

@@ -30,7 +30,7 @@ Follow a guided tutorial to customize a Virtual Assistant (available in [C#]({{s
 
 ### How do I deploy a Virtual Assistant?
 {:.no_toc}
-Learn how to deploy a Virtual Assistant by [automated scripts]({{site.baseurl}}/help/reference/deployment-scripts) or [manual configuration]({{site.baseurl}}/virtual-assistant/tutorials/deploy-assistant/cli/1-intro).
+Learn how to deploy a Virtual Assistant by [automated scripts]({{site.baseurl}}/virtual-assistant/handbook/deployment-scripts) or [manual configuration]({{site.baseurl}}/virtual-assistant/tutorials/deploy-assistant/cli/1-intro).
 
 ### How do I test a Virtual Assistant?
 {:.no_toc}
@@ -109,7 +109,7 @@ A Skill needs to be able to authenticate the request from a Virtual Assistant, [
 
 ### What is the Botskills Command Line (CLI) tool?
 {:.no_toc}
-[Botskills command line tool]({{site.baseurl}}/help/reference/botskills) allows you to automate the connection between a Virtual Assistant and your Skills; this includes the process of updating your dispatch models and creating authentication connections when needed.
+[Botskills command line tool]({{site.baseurl}}/skills/handbook/botskills) allows you to automate the connection between a Virtual Assistant and your Skills; this includes the process of updating your dispatch models and creating authentication connections when needed.
 
 ### How do I enable Bot Framework Skills on an existing v4 Bot?
 {:.no_toc}
@@ -127,7 +127,7 @@ Learn how to [convert an existing v4 Bot to a Bot Framework Skill]({{site.baseur
 
 [Power BI](https://powerbi.microsoft.com/) is a business analytics services that lets you visualize your data and share insights across your organization. You can ingest data from Application Insights into live dashboards and reports.
 
-[Learn more]({{site.baseurl}}/overview/analytics/)
+[Learn more]({{site.baseurl}}/solution-accelerators/tutorials/view-analytics/1-intro/)
 
 ### How do I configure Application Insights for a bot or Virtual Assistant?
 {:.no_toc}

docs/_docs/help/known-issues.md

@@ -62,16 +62,15 @@ QnAMaker has a central Cognitive Service resource that must be deployed in `west
 If you try to use the PowerBI analytics dashboard with your Virtual Assistant / Skills and experience a `Errors in FlowAggregates` issue or experience some telemetry not being collected this likely relates to a bug experienced in the initial version of the Virtual Assistant template and Skills which has now been addressed.
 
 1. Change `appInsights` in appSettings.config to `ApplicationInsights`
-
 ```
 "ApplicationInsights": {
     "InstrumentationKey": ""
-  }
+}
 ```
 
-2. Update your `BotServices.cs` file with the changes [here]({{site.baseurl}}/blob/master/templates/Virtual-Assistant-Template/csharp/Sample/VirtualAssistantSample/Services/BotServices.cs).
+2. Update your `BotServices.cs` file with the changes [here]({{site.repo}}/blob/master/templates/Virtual-Assistant-Template/csharp/Sample/VirtualAssistantSample/Services/BotServices.cs).
 
-3. Update your `Startup.cs` file with the changes [here]({{site.baseurl}}/blob/master/templates/Virtual-Assistant-Template/csharp/Sample/VirtualAssistantSample/Startup.cs)
+3. Update your `Startup.cs` file with the changes [here]({{site.repo}}/blob/master/templates/Virtual-Assistant-Template/csharp/Sample/VirtualAssistantSample/Startup.cs)
 
 4. Existing data in your Application Insights may cause the error to persist. You can either drop and re-create your Application insights resource updating the appSettings.config file with the new Instrumentation key or follow these [purge instructions](https://docs.microsoft.com/en-us/rest/api/application-insights/components/purge).
 
@@ -82,7 +81,7 @@ Due to a limitation with the LUIS authoring APIs the original deployment scripts
 
 This may cause you to also experience `Forbidden` LUIS errors when testing your Bot as you may have exhausted the quota for your starter LUIS key, changing from your starter LUIS subscription key will resolve this.
 
-This has now been resolved in the latest deployment scripts which you can update to following [these instructions]({{site.baseurl}}/help/reference/deployment-scripts/#updating-your-deployment-scripts). If you have an existing deployment you'll have to manually perform the following steps:
+This has now been resolved in the latest deployment scripts which you can update to following [these instructions]({{site.baseurl}}/virtual-assistant/handbook/deployment-scripts/#updating-your-deployment-scripts). If you have an existing deployment you'll have to manually perform the following steps:
 
 1. As shown below go through **each LUIS model including Dispatch**, click Assign Resoucre and locate the appropriate subscription key and then re-publish. 
 

docs/_docs/overview/virtual-assistant-solution.md

@@ -22,7 +22,7 @@ Further skills can be created and made available either through your own assista
 
 Extend a Virtual Assistant experience with reusable [Bot Framework Skills]({{site.baseurl}}/overview/skills), fulfilling common scenarios such as finding a nearby point of interest, checking off an item on a to-do list, or replying to an email. Skills can be fully customized and samples are available, enabling you to get started with multiple languages, dialogs, and code.
 
-Review analytics captured from the out-of-the-box Application Insights telemetry using the [Virtual Assistant Analytics Power BI template]({{site.baseurl}}/virtual-assistant/tutorials/create-assistant/csharp/1-intro/).
+Review analytics captured from the out-of-the-box Application Insights telemetry using the [Virtual Assistant Analytics Power BI template]({{site.baseurl}}/solution-accelerators/tutorials/view-analytics/1-intro).
 
 
 ## Key Principles
@@ -37,7 +37,7 @@ Your Virtual Assistant will be deployed within your Azure subscription. Therefor
 ### Write once, embed anywhere
 {:.no_toc}
 
-The Virtual Assistant Solution Accelerator leverages Azure Cognitive Services and can be embedded on any [Bot Framework channel](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0) such as Web Chat, Facebook Messenger, or [Microsoft Teams]({{site.baseurl}}/virtual-assistant/tutorials/enable-teams/1-intro/). You can use the [Direct Line](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline?view=azure-bot-service-4.0) channel to integrate a Virtual Assistant into your mobile app, webpage, or device. Focus on voice-first experiences using the [Direct Line Speech]({{site.baseurl}}/virtual-assistant/tutorials/enable-speech/1-intro/) channel.
+The Virtual Assistant Solution Accelerator leverages Azure Cognitive Services and can be embedded on any [Bot Framework channel](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0) such as Web Chat, Facebook Messenger, or [Microsoft Teams]({{site.baseurl}}/clients-and-channels/tutorials/enable-teams/1-intro/). You can use the [Direct Line](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline?view=azure-bot-service-4.0) channel to integrate a Virtual Assistant into your mobile app, webpage, or device. Focus on voice-first experiences using the [Direct Line Speech]({{site.baseurl}}/clients-and-channels/tutorials/enable-speech/1-intro/) channel.
 
 ### Enterprise-grade solutions
 {:.no_toc}
@@ -89,7 +89,7 @@ Clients and Channels are the ways that users can interact with the Virtual Assis
 Microsoft offers a variety of channels such as Facebook Messenger, Teams, Slack, WeChat, and many others. You can find many details around available channels in the [Bot Framework Channels documentation](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0).  
 
 Sample client applications are implementations of clients that will integrate seamlessly with your Assistant and enable Speech scenarios.
-- [Virtual Assistant Client for Android]({site.baseurl}}/clients-and-channels/clients/virtual-assistant-client/)
+- [Virtual Assistant Client for Android]({{site.baseurl}}/clients-and-channels/clients/virtual-assistant-client/)
 - Virtual Assistant Client for PowerApps *(Coming Soon)*
 
 ## Next steps

docs/_docs/overview/virtual-assistant-template.md

@@ -18,7 +18,7 @@ To learn more about project structure, see the [Create Project]({{site.baseurl}}
 
 ## Azure resource deployment
 
-The comprehensive experience requires the following Azure resources to function properly, detailed [here]({{site.baseurl}}/help/reference/deployment-scripts/).
+The comprehensive experience requires the following Azure resources to function properly, detailed [here]({{site.baseurl}}/virtual-assistant/handbook/deployment-scripts/).
 
 Resource | Description |
 -------- | ----- |
@@ -105,7 +105,7 @@ Most conversational experiences need to serve users in a variety of languages wh
 
 The Virtual Assistant addresses all of the above capabilities and assists with the deployment considerations for multi-language Dispatch, LUIS, and QNAMaker resources. Localized responses for built-in capabilities are also provided.
 
-To learn more about how multi-locale support is added, see the [localization documentation]({{site.baseurl}}/virtual-assistant/handbook/localization.md).
+To learn more about how multi-locale support is added, see the [localization documentation]({{site.baseurl}}/virtual-assistant/handbook/localization/).
 
 ### Language generation and responses
 
@@ -159,7 +159,7 @@ Within **Startup.cs** you can optionally choose to disable use of CosmosDB and s
  services.AddSingleton<IStorage>(new CosmosDbStorage(settings.CosmosDb));
 ```
 
-Deployment can be customized to omit deployment of CosmosDB and is covered in the [deployment documentation]({{site.baseurl}}/help/reference/deploymentscripts.md).
+Deployment can be customized to omit deployment of CosmosDB and is covered in the [deployment documentation]({{site.baseurl}}/virtual-assistant/handbook/deployment-scripts/).
 
 ## Handling activities
 ### Activity processing
@@ -239,7 +239,7 @@ The [**Feedback Middleware**]() provides a way to collect feedback leveraging su
 
 By default, the middleware activates at the end of every dialog but you can customize this further to suit your scenario, for example only asking for feedback when LUIS or QnA prediction scores are low or perhaps at random or a limited number of times in a time period.
 
-To learn more about the Feedback capability, see the [Feedback documentation]({{site.baseurl}}/virtual-assistant/handbook/feedback.md).
+To learn more about the Feedback capability, see the [Feedback documentation]({{site.baseurl}}/virtual-assistant/handbook/feedback/).
 
 
 ### Interruptions
@@ -301,19 +301,19 @@ The Virtual Assistant has all of the pre-requisites required for a high-quality
 
 ### Microsoft Teams
 
-The Virtual Assistant is configured out-of-the-box to integrate with [Microsoft Teams](({{site.baseurl}}/clients-and-channels/tutorials/enable-speech/1-intro/)).
+The Virtual Assistant is configured out-of-the-box to integrate with [Microsoft Teams]({{site.baseurl}}/clients-and-channels/tutorials/enable-teams/1-intro/).
 
 ## Telemetry
 
 Providing insights into the user engagement of your Bot has proven to be highly valuable. This insight can help you understand the levels of user engagement, what features of the Bot they are using (intents) along with questions people are asking that the Bot isn't able to answer - highlighting gaps in the Bot's knowledge that could be addressed through new QnA Maker articles for instance.
 
 Integration of Application Insights provides significant operational/technical insight out of the box but this can also be used to capture specific Bot related events - messages sent and received along with LUIS and QnA Maker operations. Bot level telemetry is intrinsically linked to technical and operational telemetry enabling you to inspect how a given user question was answered and vice versa.
 
-A middleware component combined with a wrapper class around the QnA Maker and LuisRecognizer SDK classes provides an elegant way to collect a consistent set of events. These consistent events can then be used by the Application Insights tooling along with tools like PowerBI. An example PowerBI dashboard is as part of the Bot Framework Solutions Github repo and works right out of the box with every Virtual Assistant template. See the [Analytics]({{site.baseurl}}/overview/analytics) section for more information.
+A middleware component combined with a wrapper class around the QnA Maker and LuisRecognizer SDK classes provides an elegant way to collect a consistent set of events. These consistent events can then be used by the Application Insights tooling along with tools like PowerBI. An example PowerBI dashboard is as part of the Bot Framework Solutions Github repo and works right out of the box with every Virtual Assistant template. See the [Analytics]({{site.baseurl}}/solution-accelerators/tutorials/view-analytics/1-intro/) section for more information.
 
 ![Analytics Example]({{site.baseurl}}/assets/images/analytics/virtual-assistant-analytics-powerbi-1.png)
 
-To learn more about Telemetry, see the [Analytics tutorial]({{site.baseurl}}/virtual-assistant/tutorials/view-analytics).
+To learn more about Telemetry, see the [Analytics tutorial]({{site.baseurl}}/solution-accelerators/tutorials/view-analytics/1-intro/).
 
 
 ## Testing
@@ -327,5 +327,5 @@ You can find these tests in a companion project to your assistant or [here]({{si
 
 A [Azure DevOps](https://azure.microsoft.com/en-us/solutions/devops/) [YAML](https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&tabs=schema) file for Continuous Integration is included within the `pipeline` folder of your assistant and provides all the steps required to build your assistant project and generate code coverage results. This can be imported into your Azure DevOps environment to create a build.
 
-In addition, documentation to create a [release pipeline]({{site.baseurl}}/howto/virtual-assistant/continuousdeployment/) is also provided enabling you to continuously deploy updates to your project to your Azure test environment and also update Dispatch, LUIS and QnAMaker resources with any changes to the LU files within source control.
+In addition, documentation to create a [release pipeline]({{site.baseurl}}/solution-accelerators/tutorials/enable-continuous-deployment/1-intro/) is also provided enabling you to continuously deploy updates to your project to your Azure test environment and also update Dispatch, LUIS and QnAMaker resources with any changes to the LU files within source control.
 

docs/_docs/skills/handbook/architecture.md

@@ -26,7 +26,7 @@ A key design goal for Skills was to maintain the consistent Activity protocol an
 ### Dispatcher
 {:.no_toc}
 
-The Dispatcher plays a central role to enabling a Bot to understand how to best process a given utterance. The Dispatch through use of the [Skill CLI]({{site.baseurl}}/reference/skills/botskills) is updated with triggering utterances for a given Skill and a new Dispatch intent is created for a given Skill. An example of a Dispatch model with a point of interest skill having been added is shown below.
+The Dispatcher plays a central role to enabling a Bot to understand how to best process a given utterance. The Dispatch through use of the [Skill CLI]({{site.baseurl}}/skills/handbook/botskills) is updated with triggering utterances for a given Skill and a new Dispatch intent is created for a given Skill. An example of a Dispatch model with a point of interest skill having been added is shown below.
 
 ![Dispatch with Skill Example]({{site.baseurl}}/assets/images/skillarchitecturedispatchexample.png)
 

docs/_docs/skills/handbook/best-practices.md

@@ -457,7 +457,7 @@ If you need a more complex prompt you can implement it by inheriting **Microsoft
 ### Enable long running tasks
 {:.no_toc}
 
-[Proactive scenarios]({{site.baseurl}}/howto/virtual-assistant/proactivemessaging) are a key part of ensuring a Skill Assistant can provide more intelligent and helpful capabilities to end users.
+[Proactive scenarios]({{site.baseurl}}/solution-accelerators/tutorials/enable-proactive-notifications/1-intro/) are a key part of ensuring a Skill Assistant can provide more intelligent and helpful capabilities to end users.
 This enables a Skill to have more intelligent interactions with a user, triggered by external events.
 
 ### Handle and log errors

docs/_docs/skills/samples/phone.md

@@ -99,7 +99,7 @@ If you plan to use the skill as part of a Virtual Assistant, the process of regi
 
 **However**, if you wish to use the Skill directly without using a Virtual Assistant, please use the following steps to manually configure Authentication for the Phone Skill. This is **not** required when using the Skill with a Virtual Assistant.
 
-Follow the general instructions [here]({{site.baseurl}}/howto/skills/manualauthsteps.md) to configure this using the scopes shown above.
+Follow the general instructions [here]({{site.baseurl}}/skills/handbook/authentication/#manual-authentication) to configure this using the scopes shown above.
 
 ## Events
 

docs/_docs/skills/tutorials/add-prebuilt-skill/6-next-steps.md

@@ -28,7 +28,7 @@ Now that you've connected a pre-built skill to your assitant, try out these othe
             <p class="card-text">Enable the Microsoft Speech Channel for your assistant.</p>
         </div>
         <div class="card-footer" style="display: flex; justify-content: center;">
-            <a href="{{site.baseurl}}/tutorials/enable-speech/1_intro" class="btn btn-primary">Get Started</a>
+            <a href="{{site.baseurl}}/clients-and-channels/tutorials/enable-speech/1-intro" class="btn btn-primary">Get Started</a>
         </div>
     </div>
     <div class="card">
@@ -37,7 +37,7 @@ Now that you've connected a pre-built skill to your assitant, try out these othe
             <p class="card-text">Enable the Microsoft Teams Channel for your assistant.</p>
         </div>
         <div class="card-footer" style="display: flex; justify-content: center;">
-            <a href="{{site.baseurl}}/tutorials/enable-teams/1_intro" class="btn btn-primary">Get Started</a>
+            <a href="{{site.baseurl}}/clients-and-channels/tutorials/enable-teams/1-intro" class="btn btn-primary">Get Started</a>
         </div>
     </div>
 </div>

docs/_docs/skills/tutorials/create-skill/csharp/8-next-steps.md

@@ -24,7 +24,7 @@ Now that you've created your skill, try the one of these tutorials:
             <div class="btn btn-primary">Get started</div>
         </div>
     </a>
-    <a href="{{site.baseurl}}/virtual-assistant/tutorials/enable-speech/1-intro/" class="card">
+    <a href="{{site.baseurl}}/clients-and-channels/tutorials/enable-speech/1-intro/" class="card">
         <div class="card-body">
             <img src="{{site.baseurl}}/assets/images/icons/speech.png" alt="Speech icon" width="48px">
             <h4 class="card-title">Enable Speech</h4>
@@ -34,7 +34,7 @@ Now that you've created your skill, try the one of these tutorials:
             <div class="btn btn-primary">Get started</div>
         </div>
     </a>
-    <a href="{{site.baseurl}}/virtual-assistant/tutorials/enable-teams/1-intro/" class="card">
+    <a href="{{site.baseurl}}/clients-and-channels/tutorials/enable-teams/1-intro/" class="card">
         <div class="card-body">
             <img src="{{site.baseurl}}/assets/images/icons/teams.png" alt="Microsoft Teams icon" width="48px">
             <h4 class="card-title">Extend to Microsoft Teams</h4>