Fixed PR warnings

Author: cfogg6

articles/cognitive-services/Speech-Service/how-to-windows-voice-assistants-get-started.md

@@ -11,15 +11,17 @@ ms.topic: conceptual
 ms.date: 04/15/2020
 ms.author: travisw
 ---
-## Overview
+# Getting started with voice assistants on Windows
 
 This guide will take you through the steps to begin developing a voice assistant on Windows.
 
 ## Set up your development environment
+
 To start developing a voice assistant for Windows, you will need to make sure you have the proper development environment.
+
 - **Visual Studio:** You will need to install [Microsoft Visual Studio 2017](https://visualstudio.microsoft.com/), Community Edition or higher
 - **Windows version**: A PC with a Windows Insider fast ring build of Windows and the Windows Insider version of the Windows SDK. This sample code is verified as working on Windows Insider Release Build 19025.vb_release_analog.191112-1600 using Windows SDK 19018. Any Build or SDK above the specified versions should be compatible.
-- **UWP development tools**: The Universal Windows Platform development workload in Visual Studio. See the UWP [Get set up](https://docs.microsoft.com/en-us/windows/uwp/get-started/get-set-up) page to get your machine ready for developing UWP Applications.
+- **UWP development tools**: The Universal Windows Platform development workload in Visual Studio. See the UWP [Get set up](https://docs.microsoft.com/windows/uwp/get-started/get-set-up) page to get your machine ready for developing UWP Applications.
 - **A working microphone and audio output**
 
 ## Obtain resources from Microsoft
@@ -40,8 +42,8 @@ For a complete voice assistant experience, the application will need a dialog se
 
 The following provides the requirements to create a simple dialog service using Direct Line Speech.
 
-- **Speech Services subscription:** A subscription for Cognitive Speech Services for speech-to-text and text-to-speech conversions. Try Speech Services for free [here](https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/get-started).
-- **Bot Framework bot:**  A bot created using Bot Framework version 4.2 or above that's subscribed to to [Direct Line Speech](https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/direct-line-speech) to enable voice input and output. [This guide](https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/tutorial-voice-enable-your-bot-speech-sdk) contains step-by-step instructions to make a simple "echo bot" and subscribe it to Direct Line Speech. You can also go go [here](https://blog.botframework.com/2018/05/07/build-a-microsoft-bot-framework-bot-with-the-bot-builder-sdk-v4/) for steps on how to create a customized bot, then follow the same steps [here](https://docs.microsoft.com/en-us/azure/cognitive-services/speech-service/tutorial-voice-enable-your-bot-speech-sdk) to subscribe it to Direct Line Speech, but with your new bot rather than the "echo bot".
+- **Speech Services subscription:** A subscription for Cognitive Speech Services for speech-to-text and text-to-speech conversions. Try Speech Services for free [here](https://docs.microsoft.com/azure/cognitive-services/speech-service/get-started).
+- **Bot Framework bot:**  A bot created using Bot Framework version 4.2 or above that's subscribed to to [Direct Line Speech](https://docs.microsoft.com/azure/cognitive-services/speech-service/direct-line-speech) to enable voice input and output. [This guide](https://docs.microsoft.com/azure/cognitive-services/speech-service/tutorial-voice-enable-your-bot-speech-sdk) contains step-by-step instructions to make a simple "echo bot" and subscribe it to Direct Line Speech. You can also go go [here](https://blog.botframework.com/2018/05/07/build-a-microsoft-bot-framework-bot-with-the-bot-builder-sdk-v4/) for steps on how to create a customized bot, then follow the same steps [here](https://docs.microsoft.com/azure/cognitive-services/speech-service/tutorial-voice-enable-your-bot-speech-sdk) to subscribe it to Direct Line Speech, but with your new bot rather than the "echo bot".
 
 ## Try out the sample app
 

articles/cognitive-services/Speech-Service/windows-voice-assistants-automatic-enablement-guidelines.md

@@ -3,7 +3,7 @@ title: Privacy guidelines for Windows Voice Assistants
 titleSuffix: Azure Cognitive Services
 description: The instructions to enable voice activation for a voice agent by default.
 services: cognitive-services
-author: cofogg
+author: cfogg6
 manager: trrwilson
 ms.service: cognitive-services
 ms.subservice: speech-service

articles/cognitive-services/Speech-Service/windows-voice-assistants-best-practices.md

@@ -19,12 +19,12 @@ Voice assistants developed on Windows 10 must implement the user experience guid
 
 ## Contents
 
-- [Summary of voice activation views supported in Windows 10](summary-of-voice-activation-views-supported-in-windows-10)
-- [Requirements summary](requirements-summary)
-- [Best practices for good listening experiences](best-practices-for-good-listening-experiences)
-- [Design guidance for in-app voice activation](design-guidance-for-in-app-voice-activation)
-- [Design guidance for voice activation above lock](design-guidance-for-voice-activation-above-lock)
-- [Design guidance for voice activation preview](design-guidance-for-voice-activation-preview)
+- [Summary of voice activation views supported in Windows 10](#summary-of-voice-activation-views-supported-in-windows-10)
+- [Requirements summary](#requirements-summary)
+- [Best practices for good listening experiences](#best-practices-for-good-listening-experiences)
+- [Design guidance for in-app voice activation](#design-guidance-for-in-app-voice-activation)
+- [Design guidance for voice activation above lock](#design-guidance-for-voice-activation-above-lock)
+- [Design guidance for voice activation preview](#design-guidance-for-voice-activation-preview)
 
 ## Summary of voice activation views supported in Windows 10
 
@@ -81,7 +81,7 @@ Available with 19H2, assistants built on Windows voice activation platform are a
 
 ### Customer opt-in
 
-Voice activation above lock is always disabled by default. Customers opt-in through the Windows settings>Privacy>Voice Activation. For details on monitoring and prompting for this setting, see the [above lock implementation guide](windows-voice-assistants-implementation-guide.md#detect-user-preference).
+Voice activation above lock is always disabled by default. Customers opt-in through the Windows settings>Privacy>Voice Activation. For details on monitoring and prompting for this setting, see the [above lock implementation guide](windows-voice-assistants-implementation-guide.md#detecting-above-lock-activation-user-preference).
 
 ### Not a lock-screen replacement
 
@@ -156,7 +156,7 @@ The Contoso assistant has a home on the taskbar: their swirling, circular icon.
 
 ![Screenshot of voice assistant on Windows replying in compact view](media/voice-assistants/windows_voice_assistant/compact_view_response.png)
 
-**Hand-off**. At any point, the assistant may handoff to its main app view to provide more information or answers or dialogue that require more screen real estate. Please refer to the [Transition from compact view to full view](windows-voice-assistants-implementation-guide.md#Transition-from-compact-view-to-full-view) section for implementation details.
+**Hand-off**. At any point, the assistant may handoff to its main app view to provide more information or answers or dialogue that require more screen real estate. Please refer to the [Transition from compact view to full view](windows-voice-assistants-implementation-guide.md#transition-from-compact-view-to-full-view) section for implementation details.
 
 ![Screenshots of voice assistant on Windows before and after expanding the compact view](media/voice-assistants/windows_voice_assistant/compact_transition.png)
 

articles/cognitive-services/Speech-Service/windows-voice-assistants-implementation-guide.md

@@ -29,7 +29,7 @@ MVA needs a microphone to be present and accessible to be able to detect a voice
 
 ### Register the application with the background service
 
-In order for MVA to launch the application in the background, the application needs to be registered with the Background Service. See a full guide for Background Service registration [here](https://docs.microsoft.com/en-us/windows/uwp/launch-resume/register-a-background-task).
+In order for MVA to launch the application in the background, the application needs to be registered with the Background Service. See a full guide for Background Service registration [here](https://docs.microsoft.com/windows/uwp/launch-resume/register-a-background-task).
 
 ### Unlock the Limited Access Feature
 
@@ -99,7 +99,7 @@ When keyword verification succeeds, the application needs to move to the foregro
 
 ### Transition from compact view to full view
 
-When your application is first activated by voice, it is started in a compact view. Please read the [Design guidance for voice activation preview](windows-voice-assistants-best-practices#design-guidance-for-voice-activation-preview) for guidance on the different views and transitions between them for voice assistants on Windows.
+When your application is first activated by voice, it is started in a compact view. Please read the [Design guidance for voice activation preview](windows-voice-assistants-best-practices.md#design-guidance-for-voice-activation-preview) for guidance on the different views and transitions between them for voice assistants on Windows.
 
 To make the transition from compact view to full app view, use the ApplicationView API `TryEnterViewModeAsync`:
 

articles/cognitive-services/Speech-Service/windows-voice-assistants-overview.md

@@ -29,5 +29,5 @@ On Windows 10 version 2004 and up, voice assistant applications can take advanta
 ## Getting Started
 
 - **Review the design guidelines:** Our [design guidelines](windows-voice-assistants-best-practices.md) lay out the key work required to provide the best possible experiences for voice activation on Windows 10.
-- **Visit the Getting Started Guide:** Start [here](windows-voice-assistants-get-started) for the steps to begin implementing voice assistants on Windows, from setting your development environment through an introduction to the UWP Voice Assistant Sample.
-- **Try out the sample app**: To experience these capabilities firsthand, visit the [UWP Voice Assistant Sample](windows-voice-assistants-sample-info) page and follow the steps to get the sample client running.
+- **Visit the Getting Started Guide:** Start [here](windows-voice-assistants-get-started.md) for the steps to begin implementing voice assistants on Windows, from setting your development environment through an introduction to the UWP Voice Assistant Sample.
+- **Try out the sample app**: To experience these capabilities firsthand, visit the [UWP Voice Assistant Sample](windows-voice-assistants-sample-info.md) page and follow the steps to get the sample client running.

articles/cognitive-services/Speech-Service/windows-voice-assistants-sample-info.md

@@ -26,7 +26,7 @@ The UWP Voice Assistant sample is a Windows Conversational Agent application tha
 The documentation provided with the sample app walks through the code path of voice activation and agent management, from the prerequisites of startup through proper cleanup.
 
 ## Links
-[The UWP Voice Assistant Sample](aka.ms/MVA/sample)
+[The UWP Voice Assistant Sample](https://aka.ms/MVA/sample)
 
 [Readme with startup instructions](https://github.com/Azure-Samples/Cognitive-Services-Voice-Assistant/blob/master/clients/csharp-uwp/README.md)
 

articles/cognitive-services/Speech-Service/windows-voice-assistants-voice-activation.md

@@ -13,9 +13,11 @@ ms.date: 04/15/2020
 ms.author: travisw
 ---
 
-## Voice Activation
+# Voice Activation
 
-Windows supports voice activation for UWP applications. The following is a walk-through of the voice activation system.
+## Walk through of voice activation
+
+Windows supports voice activation for UWP applications. The following summarizes the steps of the voice activation process, including the steps an application must take to register as activatable by voice.
 
 ### Agent Activation Runtime
 
@@ -25,7 +27,7 @@ The Agent Activation Runtime (AAR) is the ongoing process in Windows that manage
 
 The first time a voice activated application is run, it registers its app id and keyword information in a global signal configuration mapping through the ConversationalAgent APIs. Keyword information includes the location of the keyword model file, the language the keyword is in, and an ID to assign to the keyword. AAR registers all configurations in the global mapping with the hardware or software keyword spotter on the system, allowing them to detect the application's keyword.
 
-The application also [registers with the Background Service](https://docs.microsoft.com/en-us/windows/uwp/launch-resume/register-a-background-task), another process within Windows.
+The application also [registers with the Background Service](https://docs.microsoft.com/windows/uwp/launch-resume/register-a-background-task), another process within Windows.
 
 Note that this means an application cannot be activated by voice until it has been run once and registration has been allowed to complete.