final edits

Author: mrbullwinkle

articles/cognitive-services/QnAMaker/Tutorials/active-learning.md

@@ -11,9 +11,9 @@ ms.date: 06/29/2021
 
 # Enrich your knowledge base with Active Learning
 
-Over time, the Microsoft team observed that customers are asking questions, which are not part of the knowledge base. There were variations of the question that were paraphrased differently. 
+This tutorial shows you how enhance your knowledge base with active learning. If you notice that customers are asking questions, which are not part of your knowledge base. There are often variations of question that are paraphrased differently. 
 
-These variations when added as alternate questions to the relevant QnA pair, helps optimize the knowledge base to answer real world user queries. The customer can manually add alternate questions to QnA pairs through the editor. At the same time, they can also use the Active Learning feature to generate active learning suggestions based on user queries. The active learning feature, however, requires that the knowledge base receives regular user traffic to generate suggestions.
+These variations when added as alternate questions to the relevant QnA pair, help to optimize the knowledge base to answer real world user queries. You can manually add alternate questions to QnA pairs through the editor. At the same time, you can also use the active learning feature to generate active learning suggestions based on user queries. The active learning feature, however, requires that the knowledge base receives regular user traffic to generate suggestions.
 
 ## Enable Active Learning
 Active Learning is turned on by default for the Custom Question Answering feature. However, you need to manually update the Active Learning setting for QnA Maker GA. You can find more details here: [Turn on Active Learning](../how-to/use-active-learning.md#turn-on-active-learning-for-alternate-questions).

articles/cognitive-services/QnAMaker/Tutorials/adding-synonyms.md

@@ -11,7 +11,7 @@ ms.date: 06/29/2021
 
 # Improve quality of response with synonyms
 
-The team observed that users are not getting an accurate response to their queries, when they use alternate forms, synonyms or acronyms of a word. So, they decide to improve the quality of the response by using [Alterations API](/rest/api/cognitiveservices-qnamaker/QnAMaker4.0/Alterations) to add synonyms to such keywords.
+This tutorial will show you how you can improve the quality of your responses by using synonymns. Let's assume that users are not getting an accurate response to their queries, when they use alternate forms, synonyms or acronyms of a word. So, they decide to improve the quality of the response by using [Alterations API](/rest/api/cognitiveservices-qnamaker/QnAMaker4.0/Alterations) to add synonyms for keywords.
 
 ## Add synonyms using Alterations API
 
@@ -72,7 +72,7 @@ For the question and answer pair “Fix problems with Surface Pen” shown below
 As you can see, when `trouble shoot` was not added as a synonym, we got a low confidence response to the query “How to troubleshoot your surface pen”. However, after we add `trouble shoot` as a synonym to “fix problems”, we received the correct response to the query with a higher confidence score. Once, these word alterations were added, the relevance of results improved thereby improving user experience. 
 
 > [!NOTE]
-> It may be noted that synonyms are case insensitive. Synonyms also might not work as expected if you add stop words as synonyms. The list of stop words can be found here: [List of stop words](https://github.com/Azure-Samples/azure-search-sample-data/blob/master/STOPWORDS.md).
+> Synonyms are case insensitive. Synonyms also might not work as expected if you add stop words as synonyms. The list of stop words can be found here: [List of stop words](https://github.com/Azure-Samples/azure-search-sample-data/blob/master/STOPWORDS.md).
 
 For instance, if you add the abbreviation **IT** for Information technology, the system might not be able to recognize Information Technology because **IT** is a stop word and filtered when query is processed.
 

articles/cognitive-services/QnAMaker/Tutorials/guided-conversations.md

@@ -11,9 +11,9 @@ ms.date: 06/29/2021
 
 # Add guided conversations with multi-turn prompts
 
-Let's say the marketing team at Microsoft wants to build a customer support bot that answers common user queries on [Surface Pen FAQ](https://support.microsoft.com/en-us/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98). In this tutorial, we use [Surface Pen FAQ](https://support.microsoft.com/en-us/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98) to create a knowledge base.
+ In this tutorial, we use [Surface Pen FAQ](https://support.microsoft.com/en-us/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98) to create a knowledge base.
 
-The marketing team has observed that users are asking additional details about the Surface Pen product, particularly how to troubleshoot their Surface Pen but they are not getting the correct answers. So, we add more prompts to support additional scenarios and guide the users to the correct answers using multi-turn prompts.
+For this example let's assume that users are asking for additional details about the Surface Pen product, particularly how to troubleshoot their Surface Pen, but they are not getting the correct answers. So, we add more prompts to support additional scenarios and guide the users to the correct answers using multi-turn prompts.
 
 ## View QnAs with context
 While creating the knowledge base for [Surface Pen FAQ](https://support.microsoft.com/en-us/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98), we choose to enable multi-turn extraction from the source document. For more details, follow [Create multi-turn conversation from document](../how-to/multiturn-conversation.md#create-a-multi-turn-conversation-from-a-documents-structure). This lists the multi-turn prompts that are associated with QnA pairs, which can be viewed using **Show context** under **View Options**.

articles/cognitive-services/QnAMaker/Tutorials/multiple-languages.md

@@ -11,25 +11,24 @@ ms.date: 06/29/2021
 
 # Create knowledge bases in multiple languages
 
-Microsoft’s device division is increasingly receiving user queries from different countries. So, they want to add knowledge bases in multiple languages to address user queries.
-
-In this tutorial, we use the [Surface Pen FAQ](https://support.microsoft.com/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98) URL and create knowledge bases in German and English. We then publish the knowledge bases and use [GenerateAnswerAPI](/rest/api/cognitiveservices-qnamaker/QnAMaker4.0/Runtime/GenerateAnswer) to query them to get answers to FAQs in the desired language.
+This tutorial will walk through the process of creating knowledge bases in multiple languages. We use the [Surface Pen FAQ](https://support.microsoft.com/surface/how-to-use-your-surface-pen-8a403519-cd1f-15b2-c9df-faa5aa924e98) URL to create knowledge bases in German and English. We then publish the knowledge bases and use the [GenerateAnswerAPI](/rest/api/cognitiveservices-qnamaker/QnAMaker4.0/Runtime/GenerateAnswer) to query them to get answers to FAQs in the desired language.
 
 ## Create Knowledge Base in German
-To be able to create a knowledge base in more than one language, the language setting must be set at the creation of the first KB of the QnA service.
+
+To be able to create a knowledge base in more than one language, the language setting must be set at the creation of the first Knowledge Base (KB) of the QnA service.
 
 > [!NOTE]
-> The option to enable adding knowledge bases in multiple language to a service is only available as Custom Question Answering > feature as part of Text Analytics.
+> The option to enable adding knowledge bases in multiple languages to a service is only available as part of Custom Question Answering which is a feature of Text Analytics.
 >
-> If you are using the GA version, a separate QnA Maker resource would need to be created for each distinct language.
+> If you are using the GA version of QnA Maker, a separate QnA Maker resource would need to be created for each distinct language.
 
 > [!div class="mx-imgBorder"]
 > [ ![Screenshot of UI for Connect your QnA service to your knowledge base with add knowledge bases in multiple languages selected]( ../media/multiple-languages/add-knowledge-bases.png) ]( ../media/multiple-languages/add-knowledge-bases.png#lightbox)
 
 In **Step 2**: Enable “Add knowledge bases in multiple languages to this service” and choose **German** as the language of the KB from “Language” drop-down list.
 Fill relevant details in Step 3 and 4 and finally select on **Create your KB**.
 
-At this step, QnA maker reads the document and extracts QnA pairs from the source URL to create the knowledge base in the German language. The Knowledge base page opens where we can edit the contents of the knowledge base.
+At this step, QnA maker reads the document and extracts QnA pairs from the source URL to create the knowledge base in the German language. The knowledge base page opens where we can edit the contents of the knowledge base.
 
 > [!div class="mx-imgBorder"]
 > [ ![Screenshot of UI with German questions and answers]( ../media/multiple-languages/german.png) ]( ../media/multiple-languages/german.png#lightbox)

articles/cognitive-services/QnAMaker/toc.yml

@@ -123,6 +123,14 @@
   items:
   - name: Create FAQ Bot with Azure Bot Service
     href: Tutorials/create-faq-bot-with-azure-bot-service.md
+  - name: Knowledge bases with active learning
+    href: Tutorials/active-learning.md
+  - name: Guided conversations with multiturn prompts
+    href: Tutorials/guided-conversations.md
+  - name: Adding synonyms
+    href: Tutorials/adding-synonyms.md
+  - name: Knowledge bases with mutliple languages
+    href: Tutorials/multiple-languages.md    
   - name: Customize your bot
     items:
     - name: Add multiple domains to FAQ Bot