Merge pull request #78217 from Ja-Dunn/four-qna-maker-articles

edit pass: four-qna-maker-articles

Author: ShawnJackson

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

@@ -108,7 +108,7 @@ QnA Maker allows users to [collaborate](../How-to/collaborate-knowledge-base.md)
 
 ## Active learning
 
-[Active learning](../How-to/improve-knowledge-base.md) does the best job of suggesting alternative questions when it has a wide range of quality and quantity of user-based queries. It is important to allow client-applications' user queries to participate in the active learning feedback loop without censorship. Once questions are suggested in the QnA Maker portal, you can **[filter by suggestions](../How-To/improve-knowledge-base.md#add-active-learning-suggestion-to-knowledge-base)** then review and accept or reject those suggestions. 
+[Active learning](../How-to/improve-knowledge-base.md) does the best job of suggesting alternative questions when it has a wide range of quality and quantity of user-based queries. It is important to allow client-applications' user queries to participate in the active learning feedback loop without censorship. Once questions are suggested in the QnA Maker portal, you can **[filter by suggestions](../How-To/improve-knowledge-base.md)** then review and accept or reject those suggestions. 
 
 ## Next steps
 

articles/cognitive-services/QnAMaker/How-To/metadata-generateanswer-usage.md

@@ -1,7 +1,7 @@
 ---
 title: Metadata with GenerateAnswer API - QnA Maker
 titleSuffix: Azure Cognitive Services
-description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer sets. This information can be used to filter results to user queries and to store additional information that can be used in follow-up conversations.
+description: QnA Maker lets you add metadata, in the form of key/value pairs, to your question/answer sets. You can filter results to user queries, and store additional information that can be used in follow-up conversations.
 services: cognitive-services
 author: tulasim88
 manager: nitinme
@@ -12,41 +12,41 @@ ms.date: 05/30/2019
 ms.author: tulasim
 ---
 
-# Get a knowledge answer with the GenerateAnswer API and metadata
+# Get an answer with the GenerateAnswer API and metadata
 
-To get the predicted answer to a user's question, use the GenerateAnswer API. When you publish a knowledge base, this information to use this API is shown on the publish page. You can also configure the API to filter answers based on metadata tags and test the knowledge base from the endpoint with the test query string parameter.
+To get the predicted answer to a user's question, use the GenerateAnswer API. When you publish a knowledge base, you can see information about how to use this API on the **Publish** page. You can also configure the API to filter answers based on metadata tags, and test the knowledge base from the endpoint with the test query string parameter.
 
-QnA Maker lets you add metadata, in the form of key and value pairs, to your question/answer sets. This information can be used to filter results to user queries and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
+QnA Maker lets you add metadata, in the form of key and value pairs, to your sets of questions and answers. You can then use this information to filter results to user queries, and to store additional information that can be used in follow-up conversations. For more information, see [Knowledge base](../Concepts/knowledge-base.md).
 
 <a name="qna-entity"></a>
 
-## Storing questions and answers with a QnA Entity
+## Store questions and answers with a QnA entity
 
-First it's important to understand how QnA Maker stores the question/answer data. The following illustration shows a QnA entity:
+It's important to understand how QnA Maker stores the question and answer data. The following illustration shows a QnA entity:
 
-![QnA Entity](../media/qnamaker-how-to-metadata-usage/qna-entity.png)
+![Illustration of a QnA entity](../media/qnamaker-how-to-metadata-usage/qna-entity.png)
 
-Each QnA entity has a unique and persistent ID. The ID can be used to make updates to a particular QnA entity.
+Each QnA entity has a unique and persistent ID. You can use the ID to make updates to a particular QnA entity.
 
 <a name="generateanswer-api"></a>
 
 ## Get answer predictions with the GenerateAnswer API
 
-You use the GenerateAnswer API in your Bot or application to query your knowledge base with a user question to get the best match from the question/answer sets.
+You use the GenerateAnswer API in your bot or application to query your knowledge base with a user question, to get the best match from the question and answer sets.
 
 <a name="generateanswer-endpoint"></a>
 
 ## Publish to get GenerateAnswer endpoint 
 
-Once you publish your knowledge base, either from the [QnA Maker portal](https://www.qnamaker.ai), or using the [API](https://go.microsoft.com/fwlink/?linkid=2092179), you can get the details of your GenerateAnswer endpoint.
+After you publish your knowledge base, either from the [QnA Maker portal](https://www.qnamaker.ai), or by using the [API](https://go.microsoft.com/fwlink/?linkid=2092179), you can get the details of your GenerateAnswer endpoint.
 
 To get your endpoint details:
 1. Sign in to [https://www.qnamaker.ai](https://www.qnamaker.ai).
-1. In **My knowledge bases**, click on **View Code** for your knowledge base.
-    ![my knowledge bases](../media/qnamaker-how-to-metadata-usage/my-knowledge-bases.png)
+1. In **My knowledge bases**, select **View Code** for your knowledge base.
+    ![Screenshot of My knowledge bases](../media/qnamaker-how-to-metadata-usage/my-knowledge-bases.png)
 1. Get your GenerateAnswer endpoint details.
 
-    ![endpoint details](../media/qnamaker-how-to-metadata-usage/view-code.png)
+    ![Screenshot of endpoint details](../media/qnamaker-how-to-metadata-usage/view-code.png)
 
 You can also get your endpoint details from the **Settings** tab of your knowledge base.
 
@@ -65,10 +65,10 @@ https://{QnA-Maker-endpoint}/knowledgebases/{knowledge-base-ID}/generateAnswer
 |HTTP request property|Name|Type|Purpose|
 |--|--|--|--|
 |URL route parameter|Knowledge base ID|string|The GUID for your knowledge base.|
-|URL route parameter|QnAMaker endpoint host|string|The hostname of the endpoint deployed in your Azure subscription. This is available on the Settings page after you publish the knowledge base. |
+|URL route parameter|QnAMaker endpoint host|string|The hostname of the endpoint deployed in your Azure subscription. This is available on the **Settings** page after you publish the knowledge base. |
 |Header|Content-Type|string|The media type of the body sent to the API. Default value is: ``|
 |Header|Authorization|string|Your endpoint key (EndpointKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).|
-|Post Body|JSON object|JSON|The question with settings|
+|Post Body|JSON object|JSON|The question with settings.|
 
 
 The JSON body has several settings:
@@ -79,7 +79,7 @@ The JSON body has several settings:
 |`top`|optional|integer|The number of ranked results to include in the output. The default value is 1.|
 |`userId`|optional|string|A unique ID to identify the user. This ID will be recorded in the chat logs.|
 |`scoreThreshold`|optional|integer|Only answers with confidence score above this threshold will be returned. The default value is 0.|
-|`isTest`|optional|boolean|If set to true, returns results from `testkb` Search index instead of published index.|
+|`isTest`|optional|Boolean|If set to true, returns results from `testkb` Search index instead of published index.|
 |`strictFilters`|optional|string|If specified, tells QnA Maker to return only answers that have the specified metadata. Use `none` to indicate response should have no metadata filters. |
 |`RankerType`|optional|string|If specified as `QuestionOnly`, tells QnA Maker to search questions only. If not specified, QnA Maker searches questions and answers.
 
@@ -142,19 +142,19 @@ A successful response returns a status of 200 and a JSON response.
 
 <a name="metadata-example"></a>
 
-## Using metadata allows you to filter answers by custom metadata tags
+## Use metadata to filter answers by custom metadata tags
 
-Adding metadata allows you to filter the answers by these metadata tags. Add the metadata column from the **View Options** menu. Add metadata to your knowledge base by clicking on the metadata **+** icon to add a metadata pair. This pair consists of one key and one value.
+Adding metadata allows you to filter the answers by these metadata tags. Add the metadata column from the **View Options** menu. Add metadata to your knowledge base by selecting the metadata **+** icon to add a metadata pair. This pair consists of one key and one value.
 
-![add metadata](../media/qnamaker-how-to-metadata-usage/add-metadata.png)
+![Screenshot of adding metadata](../media/qnamaker-how-to-metadata-usage/add-metadata.png)
 
 <a name="filter-results-with-strictfilters-for-metadata-tags"></a>
 
 ## Filter results with strictFilters for metadata tags
 
-Consider the user question "When does this hotel close?" where the intent is implied for the restaurant "Paradise."
+Consider the user question "When does this hotel close?", where the intent is implied for the restaurant "Paradise."
 
-Since results are required only for the restaurant "Paradise", you can set a filter in the GenerateAnswer call on the metadata "Restaurant Name", as follows.
+Because results are required only for the restaurant "Paradise", you can set a filter in the GenerateAnswer call on the metadata "Restaurant Name". The following example shows this:
 
 ```json
 {
@@ -172,7 +172,7 @@ Since results are required only for the restaurant "Paradise", you can set a fil
 
 ## Use question and answer results to keep conversation context
 
-The response to the GenerateAnswer contains the corresponding metadata information of the matched question/answer set. This information can be used in your client application to store the context of the previous conversation for use in later conversations. 
+The response to the GenerateAnswer contains the corresponding metadata information of the matched question and answer set. You can use this information in your client application to store the context of the previous conversation for use in later conversations. 
 
 ```json
 {
@@ -217,7 +217,7 @@ You can search through the published kb, using `isTest=false`, or in the test kb
 
 ## Next steps
 
-The publish page also provides information to generate an answer with [Postman](../Quickstarts/get-answer-from-kb-using-postman.md) and [cURL](../Quickstarts/get-answer-from-kb-using-curl.md). 
+The **Publish** page also provides information to generate an answer with [Postman](../Quickstarts/get-answer-from-kb-using-postman.md) and [cURL](../Quickstarts/get-answer-from-kb-using-curl.md). 
 
 > [!div class="nextstepaction"]
 > [Create a knowledge base](./create-knowledge-base.md)

articles/cognitive-services/QnAMaker/Quickstarts/create-publish-knowledge-base.md

@@ -1,5 +1,5 @@
 ---
-title: "Create, train, publish knowledge base - QnA Maker"
+title: "Create, train, and publish knowledge base - QnA Maker"
 titleSuffix: Azure Cognitive Services 
 description: You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. The QnA Maker knowledge base in this example is created from a simple FAQ webpage to answer questions on BitLocker key recovery.
 author: diberry
@@ -14,7 +14,7 @@ ms.author: diberry
 
 # Create, train, and publish your QnA Maker knowledge base
 
-You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. The QnA Maker knowledge base in this example is created from a simple FAQ webpage to answer questions on BitLocker key recovery.
+You can create a QnA Maker knowledge base (KB) from your own content, such as FAQs or product manuals. This article includes an example of creating a QnA Maker knowledge base from a simple FAQ webpage, to answer questions on BitLocker key recovery.
 
 ## Prerequisite
 
@@ -23,36 +23,36 @@ You can create a QnA Maker knowledge base (KB) from your own content, such as FA
 
 ## Create a QnA Maker knowledge base
 
-1. Sign in to [QnAMaker.ai](https://QnAMaker.ai) portal with your Azure credentials.
+1. Sign in to the [QnAMaker.ai](https://QnAMaker.ai) portal with your Azure credentials.
 
 1. On the QnA Maker portal, select **Create a knowledge base**.
 
-   ![Create new knowledge base](../media/qna-maker-create-kb.png)
+   ![Screenshot of QnA Maker portal](../media/qna-maker-create-kb.png)
 
 1. On the **Create** page, in step 1, select **Create a QnA service**. You are directed to the [Azure portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesQnAMaker) to set up a QnA Maker service in your subscription. If the Azure portal times out, select **Try again** on the site. After you connect, your Azure dashboard appears.
 
-1. After you successfully create a new QnA Maker service in Azure, return to qnamaker.ai/create. Select your QnA service from the drop-down lists in step 2. If you created a new QnA service, be sure to refresh the page.
+1. After you successfully create a new QnA Maker service in Azure, return to qnamaker.ai/create. Select your QnA Maker service from the drop-down lists in step 2. If you created a new QnA Maker service, be sure to refresh the page.
 
-   ![Select a QnA service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
+   ![Screenshot of selecting a QnA Maker service knowledge base](../media/qnamaker-quickstart-kb/qnaservice-selection.png)
 
 1. In step 3, name your knowledge base **My Sample QnA KB**.
 
 1. To add content to your knowledge base, select three types of data sources. In step 4, under **Populate your KB**, add the 
    [BitLocker Recovery FAQ](https://docs.microsoft.com/windows/security/information-protection/bitlocker/bitlocker-overview-and-requirements-faq) URL in the **URL** box.
 
-   ![Select a QnA service knowledge base](../media/qnamaker-quickstart-kb/add-datasources.png)
+   ![Screenshot of adding data sources](../media/qnamaker-quickstart-kb/add-datasources.png)
 
 1. In step 5, select **Create your KB**.
 
-1. While the knowledge base is being created, a pop-up window appears. The extraction process takes a few minutes to read the HTML page and identify questions and answers.
+1. While QnA Maker creates the knowledge base, a pop-up window appears. The extraction process takes a few minutes to read the HTML page and identify questions and answers.
 
-1. After the knowledge base is successfully created, the **Knowledge base** page opens. You can edit the contents of the knowledge base on this page.
+1. After QnA Maker successfully creates the knowledge base, the **Knowledge base** page opens. You can edit the contents of the knowledge base on this page.
 
 ## Edit the knowledge base
 
-1. In the QnA Maker portal, on the **Edit** section, **Add QnA pair** to add a new row to the knowledge base. Under **Question**, enter **Hi.** Under **Answer**, enter **Hello. Ask me BitLocker questions.**
+1. In the QnA Maker portal, on the **Edit** section, select **Add QnA pair** to add a new row to the knowledge base. Under **Question**, enter **Hi.** Under **Answer**, enter **Hello. Ask me BitLocker questions.**
 
-    ![Add a QnA pair](../media/qnamaker-quickstart-kb/add-qna-pair.png)
+    ![Screenshot of QnA Maker portal](../media/qnamaker-quickstart-kb/add-qna-pair.png)
 
 1. In the upper right, select **Save and train** to save your edits and train the QnA Maker model. Edits aren't kept unless they're saved.
 
@@ -62,41 +62,42 @@ You can create a QnA Maker knowledge base (KB) from your own content, such as FA
 
 1. Select **Inspect** to examine the response in more detail. The test window is used to test your changes to the knowledge base before they're published.
 
-    ![Test Panel](../media/qnamaker-quickstart-kb/inspect.png)
+    ![Screenshot of test panel](../media/qnamaker-quickstart-kb/inspect.png)
 
 1. Select **Test** again to close the **Test** pop-up.
 
 ## Publish the knowledge base
 
 When you publish a knowledge base, the question and answer contents of your knowledge base moves from the test index to a production index in Azure search.
 
-![Publish prod test index](../media/qnamaker-how-to-publish-kb/publish-prod-test.png)
+![Screenshot of moving the contents of your knowledge base](../media/qnamaker-how-to-publish-kb/publish-prod-test.png)
 
 1. In the QnA Maker portal, in the menu next to **Edit**, select **Publish**. Then to confirm, select **Publish** on the page.
 
 1. The QnA Maker service is now successfully published. You can use the endpoint in your application or bot code.
 
-    ![Publish](../media/qnamaker-quickstart-kb/publish-sucess.png)
+    ![Screenshot of successful publishing](../media/qnamaker-quickstart-kb/publish-sucess.png)
 
 ## Create a bot
 
-Creating a bot is always available after publishing, from the **Publish** page. 
+After publishing, you can create a bot from the **Publish** page: 
 
 * You can create several bots quickly, all pointing to the same knowledge base for different regions or pricing plans for the individual bots. 
 * If you want only one bot for the knowledge base, use the **View all your bots on the Azure portal** link to view a list of your current bots. 
-* When you make changes to the knowledge base and republish, you do not need to take further action with the bot. It is already configured to work with the knowledge base and will work with all future changes to the knowledge base. Every time you publish a knowledge base - all the bots connected to it are automatically updated
 
-1. In the QnA Maker portal, on the **Publish** page, select **Create bot**. This button appears only after the knowledge base is published.
+When you make changes to the knowledge base and republish, you don't need to take further action with the bot. It's already configured to work with the knowledge base, and works with all future changes to the knowledge base. Every time you publish a knowledge base, all the bots connected to it are automatically updated.
 
-    ![In the QnA Maker portal, go to the Publish page, and publish your knowledge base. Select Create Bot.](../media/qnamaker-create-publish-knowledge-base/create-bot-from-published-knowledge-base-page.png)
+1. In the QnA Maker portal, on the **Publish** page, select **Create bot**. This button appears only after you've published the knowledge base.
 
-1. A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure the Azure bot service. For more information on these configuration settings, see [Create a QnA Bot with Azure Bot Service v4](../tutorials/create-qna-bot.md) tutorial.
+    ![Screenshot of creating a bot](../media/qnamaker-create-publish-knowledge-base/create-bot-from-published-knowledge-base-page.png)
+
+1. A new browser tab opens for the Azure portal, with the Azure Bot Service's creation page. Configure the Azure bot service. For more information on these configuration settings, see [Create a QnA Bot with Azure Bot Service v4](../tutorials/create-qna-bot.md).
 
-    * Do not change the following settings in the Azure portal when creating the bot. They are pre-populated for your existing knowledge base: 
+    * Don't change the following settings in the Azure portal when creating the bot. They are pre-populated for your existing knowledge base: 
         * QnA Auth Key
-        * App service plan/Location
+        * App service plan and location
         * Azure Storage
-    * The bot and QnA Maker can share the web app service _plan_ but can't share the web app. This means the **app name** must be different from the app name you used when you created the QnA Maker service. 
+    * The bot and QnA Maker can share the web app service plan, but can't share the web app. This means the **app name** must be different from the app name you used when you created the QnA Maker service. 
 
 
 ## Next steps