edits from Prakul

Author: diberry

articles/cognitive-services/QnAMaker/Concepts/best-practices.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: conceptual
-ms.date: 01/10/2020
+ms.date: 01/27/2020
 ms.author: diberry
 ms.custom: seodec18
 ---
@@ -25,7 +25,7 @@ In general, FAQ pages should be stand-alone and not combined with other informat
 
 ### Configuring multi-turn
 
-Create your knowledge base with multi-turn extraction enabled. If your knowledge base does or should support question hierarchy, this hierarchy can be extracted from the document or created after the document is extracted.
+[Create your knowledge base](../how-to/multiturn-conversation.md#create-a-multi-turn-conversation-from-a-documents-structure) with multi-turn extraction enabled. If your knowledge base does or should support question hierarchy, this hierarchy can be extracted from the document or created after the document is extracted.
 
 <!--is this a global setting that can only be configured at kb creation time? -->
 
@@ -46,9 +46,16 @@ Your user may enter questions with either a conversational style of text, `How d
 
 The best answers are simple answers but not too simple. Do not use answers such as `yes` and `no`. If your answer should link to other sources or provide a rich experience with media and links, use [metadata tagging](../how-to/edit-knowledge-base.md#add-metadata) to distinguish between answers, then [submit the query](../how-to/metadata-generateanswer-usage.md#generateanswer-request-configuration) with metadata tags in the `strictFilters` property to get the correct answer version.
 
+|Answer|Follup-up prompts|
+|--|--|
+|Power down the Surface laptop with the power button on the keyboard.|* Key-combinations to sleep, shut down, and restart.<br>* How to hard-boot a Surface laptop<br>* How to change the BIOS for a Surface laptop<br>* Differences between sleep, shut down and restart|
+|Customer service is available via phone, Skype, and text message 24 hours a day.|* Contact information for sales.<br> * Office and store locations and hours for an in-person visit.<br> * Accessories for a Surface laptop.|
+
 ## Chit-Chat
 Add chit-chat to your bot, to make your bot more conversational and engaging, with low effort. You can easily add chit-chat data sets from pre-defined personalities when creating your KB, and change them at any time. Learn how to [add chit-chat to your KB](../How-To/chit-chat-knowledge-base.md).
 
+Chit-chat is supported in [many languages](../how-to/chit-chat-knowledge-base?branch=pr-en-us-100699#language-support).
+
 ### Choosing a personality
 Chit-chat is supported for several predefined personalities:
 

articles/cognitive-services/QnAMaker/Concepts/query-knowledge-base.md

@@ -25,7 +25,7 @@ The process is explained in the following table.
 |2|QnA Maker preprocesses the user query with language detection, spellers, and word breakers.|
 |3|This preprocessing is taken to alter the user query for the best search results.|
 |4|This altered query is sent to an Azure Cognitive Search Index, which receives the `top` number of results. If the correct answer isn't in these results, increase the value of `top` slightly. Generally, a value of 10 for `top` works in 90% of queries.|
-|5QnA Maker uses syntactic and semantic based featurization to determine the similarity between the user query and the fetched QnA results.|
+|5|QnA Maker uses syntactic and semantic based featurization to determine the similarity between the user query and the fetched QnA results.|
 |6|The machine-learned ranker model uses the different features, from step 5, to determine the confidence scores and the new ranking order.|
 |7|The new results are returned to the client application in ranked order.|
 |||
@@ -47,8 +47,8 @@ A user query is the question that the end user asks of the knowledge base, such
     "scoreThreshold": 20,
     "strictFilters": [
     {
-        "name": "feature",
-        "value": "collaboration"
+        "name": "QuestionType",
+        "value": "Support"
     }],
     "userId": "sd53lsY="
 }
@@ -67,20 +67,22 @@ The HTTP response is the answer retrieved from the knowledge base, based on the
     "answers": [
         {
             "questions": [
-                "What is the closing time?"
+                "How do I add a collaborator to my app?",
+                "What access control is provided for the app?",
+                "How do I find user management and security?"
             ],
-            "answer": "10.30 PM",
+            "answer": "Use the Azure portal to add a collaborator using Access Control (IAM)",
             "score": 100,
             "id": 1,
             "source": "Editorial",
             "metadata": [
                 {
-                    "name": "restaurant",
-                    "value": "Contoso"
+                    "name": "QuestionType",
+                    "value": "Support"
                 },
                 {
-                    "name": "location",
-                    "value": "New York"
+                    "name": "ToolDependency",
+                    "value": "Azure Portal"
                 }
             ]
         }