Merge pull request #86001 from diberry/0820-qna-freshness-1

[Cogsvcs] QnA Maker - freshness

Author: v-albemi

articles/cognitive-services/QnAMaker/How-To/business-continuity-plan.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: conceptual
-ms.date: 01/14/2019
+ms.date: 08/20/2019
 ms.author: diberry
 ---
 

articles/cognitive-services/QnAMaker/How-To/collaborate-knowledge-base.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: conceptual
-ms.date: 01/14/2019
+ms.date: 08/20/2019
 ms.author: diberry
 ---
 
@@ -22,23 +22,23 @@ Perform the following steps to share your QnA Maker service with someone:
 
     ![QnA Maker resource list](../media/qnamaker-how-to-collaborate-knowledge-base/qnamaker-resource-list.PNG)
 
-2. Go to the **Access Control (IAM)** tab.
+1. Go to the **Access Control (IAM)** tab.
 
     ![QnA Maker IAM](../media/qnamaker-how-to-collaborate-knowledge-base/qnamaker-iam.PNG)
 
-3. Select **Add**.
+1. Select **Add**.
 
     ![QnA Maker IAM add](../media/qnamaker-how-to-collaborate-knowledge-base/qnamaker-iam-add.PNG)
 
-4. Select the **Owner** or the **Contributor** role. You cannot grant read-only access through Role-Based Access Control. Owner and Contributor role has read-write access right to QnA Maker service.
+1. Select the **Owner** or the **Contributor** role. You cannot grant read-only access through Role-Based Access Control. Owner and Contributor roles have read-write access permissions to the QnA Maker service.
 
     ![QnA Maker IAM add role](../media/qnamaker-how-to-collaborate-knowledge-base/qnamaker-iam-add-role.PNG)
 
-5. Enter the email you want to share with, and press save.
+1. Enter the user's email address and press **Save**.
 
     ![QnA Maker IAM add email](../media/qnamaker-how-to-collaborate-knowledge-base/qnamaker-iam-add-email.PNG)
 
-Now when the person you shared your QnA Maker service with, logs into the [QnA Maker portal](https://qnamaker.ai) they can see all the knowledge bases in that service.
+When the person, you shared your QnA Maker service with, logs into the [QnA Maker portal](https://qnamaker.ai) they can see all the knowledge bases in that service.
 
 Remember, you cannot share a particular knowledge base in a QnA Maker service. If you want more granular access control, consider distributing your knowledge bases across different QnA Maker services.
 

articles/cognitive-services/QnAMaker/How-To/language-knowledge-base.md

@@ -8,33 +8,34 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: conceptual
-ms.date: 01/14/2019
+ms.date: 08/20/2019
 ms.author: diberry
 ---
 # Language support of knowledge base content for QnA Maker
+
 QnA Maker supports knowledge base content in many languages. However, each QnA Maker service should be reserved for a single language. The first knowledge base created targeting a particular QnA Maker service sets the language of that service. See [here](../Overview/languages-supported.md) for the list of supported languages.
 
 The language is automatically recognized from the content of the data sources being extracted. Once you create a new QnA Maker Service and a new Knowledge Base in that service, you can verify that the language has been set correctly.
 
-1. Navigate to the [Azure Portal](https://portal.azure.com/).
+1. Navigate to the [Azure portal](https://portal.azure.com/).
 
-2. Select **resource groups** and navigate to the resource group where the QnA Maker service is deployed and select the **Azure Search** resource.
+1. Select **resource groups** and navigate to the resource group where the QnA Maker service is deployed and select the **Azure Search** resource.
 
     ![Select Azure Search resource](../media/qnamaker-how-to-language-kb/select-azsearch.png)
 
-3. Select the **testkb** index. This Azure Search index is always the first one created and it contains the saved content of all the knowledge bases in that service. 
+1. Select the **testkb** index. This Azure Search index is always the first one created and it contains the saved content of all the knowledge bases in that service. 
 
     ![Select the Test KB](../media/qnamaker-how-to-language-kb/select-testkb.png)
 
-4. Select **Fields** section showing the testkb details.
+1. Select **Fields** section showing the _testkb_ details.
 
     ![Select Fields](../media/qnamaker-how-to-language-kb/selectfields.png)
 
-5. Check the box for **Analyzer** to see language details.
+1. Check the box for **Analyzer** to see language details.
 
     ![Select Analyzer](../media/qnamaker-how-to-language-kb/select-analyzer.png)
 
-6. You should find that the Analyzer is set to a particular language. This language was automatically detected during the knowledge base creation step. This language cannot be changed once the resource is created.
+1. You should find that the _Analyzer_ is set to a specific language. This language was automatically detected during the knowledge base creation step from the imported files and URLs. This language cannot be changed once the resource is created.
 
     ![Selected Analyzer](../media/qnamaker-how-to-language-kb/selected-analyzer.png)
 

articles/cognitive-services/QnAMaker/How-To/troubleshooting-runtime.md

@@ -8,41 +8,45 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: qna-maker
 ms.topic: article
-ms.date: 01/14/2019
+ms.date: 08/20/2019
 ms.author: diberry
 ms.custom: seodec18
 ---
 
 # Troubleshooting tips to support the QnA Maker service and runtime
-QnAMaker comprises of components hosted in the user's Azure account. Debugging may require users to manipulate their QnAMaker Azure resources or provide QnAMaker support team with additional information about their setup.
+
+QnAMaker comprises resources hosted in the user's Azure subscription. Debugging may require users to manipulate their Azure QnAMaker resources or provide the QnAMaker support team with additional information about their setup.
 
 ## How to get latest QnAMaker runtime updates
-QnAMaker runtime is part of the Azure App Service deployed when you [create a QnAMaker service](./set-up-qnamaker-service-azure.md) in Azure portal. Updates are made periodically to the runtime. QnA Maker App Service is on auto update mode post our Apr 2019 site extension release (version 5+). This is already designed to take care of ZERO downtime during upgrades. You can check your current version at https://www.qnamaker.ai/UserSettings. If your version is older than version 5.x, you must restart the App Service to apply the latest updates to apply to your QnAMaker setup.
+
+The QnAMaker runtime is part of the Azure App Service deployed when you [create a QnAMaker service](./set-up-qnamaker-service-azure.md) in Azure portal. Updates are made periodically to the runtime. QnA Maker App Service is on auto-update mode after the Apr 2019 site extension release (version 5+). This is already designed to take care of ZERO downtime during upgrades. 
+
+You can check your current version at https://www.qnamaker.ai/UserSettings. If your version is older than version 5.x, you must restart the App Service to apply the latest updates.
 
 1. Go to your QnAMaker service (resource group) in the [Azure portal](https://portal.azure.com)
 
     ![QnAMaker Azure resource group](../media/qnamaker-how-to-troubleshoot/qnamaker-azure-resourcegroup.png)
 
-2. Click on the App Service and open the Overview section
+1. Click on the App Service and open the Overview section
 
      ![QnAMaker App Service](../media/qnamaker-how-to-troubleshoot/qnamaker-azure-appservice.png)
 
-3. Restart the App service. It should complete within a couple of seconds. Note that your downstream applications/bots build on this QnAMaker service will be unavailable to end-users during this restart period.
+1. Restart the App service. It should complete within a couple of seconds. Note that any dependent applications or bots that use this QnAMaker service will be unavailable to end-users during this restart period.
 
     ![QnAMaker appservice restart](../media/qnamaker-how-to-upgrade-qnamaker/qnamaker-appservice-restart.png)
 
 ## How to get the QnAMaker service hostname
-QnAMaker service hostname is useful for debugging purposes when you contact QnAMaker Support or UserVoice. The hostname is a URL of this form: https://*{hostname}*.azurewebsites.net.
+QnAMaker service hostname is useful for debugging purposes when you contact QnAMaker Support or UserVoice. The hostname is a URL in this form: https://*{hostname}*.azurewebsites.net.
 
 1. Go to your QnAMaker service (resource group) in the [Azure portal](https://portal.azure.com)
 
     ![QnAMaker Azure resource group in Azure portal](../media/qnamaker-how-to-troubleshoot/qnamaker-azure-resourcegroup.png)
 
-2. Click on the App Service
+1. Select the App Service associated with the QnA Maker resource. Typically, the names are the same.
 
      ![Select QnAMaker App Service](../media/qnamaker-how-to-troubleshoot/qnamaker-azure-appservice.png)
 
-3. The hostname URL is available in the Overview section
+1. The hostname URL is available in the Overview section
 
     ![QnAMaker hostname](../media/qnamaker-how-to-troubleshoot/qnamaker-azure-gethostname.png)