Merge pull request #101013 from diberry/diberry/0113-qs-sdk-1-page

[Cogsvcs] QnA Maker - Quickstart SDK

Author: v-albemi

.openpublishing.redirection.json

@@ -595,6 +595,22 @@
       "redirect_url": "/azure/machine-learning",
       "redirect_document_id": false
     },
+
+    {
+      "source_path": "articles/cognitive-services/QnAMaker/Quickstarts/create-publish-kb-nodejs-sdk.md",
+      "redirect_url": "/azure/cognitive-services//QnAMaker/Quickstarts/quickstart-sdk",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/QnAMaker/Quickstarts/create-publish-kb-csharp-sdk.md",
+      "redirect_url": "/azure/cognitive-services//QnAMaker/Quickstarts/quickstart-sdk",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/QnAMaker/Quickstarts/python-sdk.md",
+      "redirect_url": "/azure/cognitive-services//QnAMaker/Quickstarts/quickstart-sdk",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/QnAMaker/Quickstarts/create-knowledge-rest-api-nodejs.md",
       "redirect_url": "/azure/cognitive-services//QnAMaker/Quickstarts/publish-kb-nodejs",

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

@@ -36,7 +36,7 @@ You use the [GenerateAnswer API](https://docs.microsoft.com/rest/api/cognitivese
 
 <a name="generateanswer-endpoint"></a>
 
-## Publish to get GenerateAnswer endpoint 
+## Publish to get GenerateAnswer endpoint
 
 After you publish your knowledge base, either from the [QnA Maker portal](https://www.qnamaker.ai), or by using the [API](https://docs.microsoft.com/rest/api/cognitiveservices/qnamaker/knowledgebase/publish), you can get the details of your GenerateAnswer endpoint.
 
@@ -54,15 +54,15 @@ You can also get your endpoint details from the **Settings** tab of your knowled
 
 ## GenerateAnswer request configuration
 
-You call GenerateAnswer with an HTTP POST request. For sample code that shows how to call GenerateAnswer, see the [quickstarts](../quickstarts/create-publish-kb-csharp-sdk.md#generate-an-answer-from-the-knowledge-base). 
+You call GenerateAnswer with an HTTP POST request. For sample code that shows how to call GenerateAnswer, see the [quickstarts](../quickstarts/quickstart-sdk.md#generate-an-answer-from-the-knowledge-base).
 
 The POST request uses:
 
 * Required [URI parameters](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerruntime/runtime/train#uri-parameters)
 * Required [header property](https://docs.microsoft.com/azure/cognitive-services/qnamaker/quickstarts/get-answer-from-knowledge-base-nodejs#add-a-post-request-to-send-question-and-get-an-answer), `Authorization`, for security
-* Required [body properties](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerruntime/runtime/train#feedbackrecorddto). 
+* Required [body properties](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerruntime/runtime/train#feedbackrecorddto).
 
-The GenerateAnswer URL has the following format: 
+The GenerateAnswer URL has the following format:
 
 ```
 https://{QnA-Maker-endpoint}/knowledgebases/{knowledge-base-ID}/generateAnswer
@@ -90,7 +90,7 @@ An example JSON body looks like:
 
 Learn more about [rankerType](../concepts/best-practices.md#choosing-ranker-type).
 
-The previous JSON requested only answers that are at 30% or above the threshold score. 
+The previous JSON requested only answers that are at 30% or above the threshold score.
 
 <a name="generateanswer-response"></a>
 
@@ -120,7 +120,7 @@ The [response](https://docs.microsoft.com/rest/api/cognitiveservices/qnamakerrun
 }
 ```
 
-The previous JSON responded with an answer with a score of 38.5%. 
+The previous JSON responded with an answer with a score of 38.5%.
 
 ## Use QnA Maker with a bot in C#
 
@@ -139,7 +139,7 @@ qnaOptions.ScoreThreshold = 0.3F;
 var response = await _services.QnAServices[QnAMakerKey].GetAnswersAsync(turnContext, qnaOptions);
 ```
 
-The previous JSON requested only answers that are at 30% or above the threshold score. 
+The previous JSON requested only answers that are at 30% or above the threshold score.
 
 The Support bot has [an example](https://github.com/microsoft/BotBuilder-Samples/blob/master/experimental/qnamaker-support/csharp_dotnetcore/Service/SupportBotService.cs#L418) with this code.
 
@@ -159,7 +159,7 @@ var qnaMakerOptions = {
 var qnaResults = await this.qnaMaker.getAnswers(stepContext.context, qnaMakerOptions);
 ```
 
-The previous JSON requested only answers that are at 30% or above the threshold score. 
+The previous JSON requested only answers that are at 30% or above the threshold score.
 
 The Support bot has [an example](https://github.com/microsoft/BotBuilder-Samples/blob/master/experimental/qnamaker-activelearning/javascript_nodejs/Helpers/dialogHelper.js#L36) with this code.
 
@@ -195,7 +195,7 @@ Because results are required only for the restaurant "Paradise", you can set a f
 
 ## Use question and answer results to keep conversation context
 
-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. 
+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
 {

articles/cognitive-services/QnAMaker/Quickstarts/quickstart-sdk.md

@@ -0,0 +1,32 @@
+---
+title: "Quickstart: Use SDK to create and manage knowledge base - QnA Maker"
+description: This quickstart shows you how to create and manage your knowledge base using the client SDK.
+ms.topic: quickstart
+ms.date: 01/13/2020
+zone_pivot_groups: programming-languages-set-six
+---
+
+# Quickstart: Create and manage knowledge base
+
+Get started with the QnA Maker client library. Follow these steps to install the package and try out the example code for basic tasks.  QnA Maker enables you to power a question-and-answer service from your semi-structured content like FAQ documents, URLs, and product manuals.
+
+::: zone pivot="programming-language-csharp"
+[!INCLUDE [Get intent with C# and REST](../includes/quickstart-sdk-csharp.md)]
+::: zone-end
+
+::: zone pivot="programming-language-python"
+[!INCLUDE [Get intent with Python and REST](../includes/quickstart-sdk-python.md)]
+::: zone-end
+
+::: zone pivot="programming-language-nodejs"
+[!INCLUDE [Get intent with Node.js and REST](../includes/quickstart-sdk-nodejs.md)]
+::: zone-end
+
+## Next steps
+
+> [!div class="nextstepaction"]
+>[Tutorial: Create and answer a KB](../tutorials/create-publish-query-in-portal.md)
+
+* [What is the QnA Maker API?](../Overview/overview.md)
+* [Edit a knowledge base](../how-to/edit-knowledge-base.md)
+* [Get usage analytics](../how-to/get-analytics-knowledge-base.md)

articles/cognitive-services/QnAMaker/Quickstarts/create-publish-kb-csharp-sdk.md renamed to articles/cognitive-services/QnAMaker/includes/quickstart-sdk-csharp.md

@@ -1,21 +1,9 @@
 ---
 title: "Quickstart: QnA Maker client library for .NET"
-titleSuffix: Azure Cognitive Services
 description: This quickstart shows how to get started with the QnA Maker client library for .NET. Follow these steps to install the package and try out the example code for basic tasks.  QnA Maker enables you to power a question-and-answer service from your semi-structured content like FAQ documents, URLs, and product manuals.
-services: cognitive-services
-author: diberry
-manager: nitinme
-ms.service: cognitive-services
-ms.subservice: qna-maker
 ms.topic: quickstart
-ms.date: 12/16/2019
-ms.author: diberry
+ms.date: 01/13/2020
 ---
-
-# Quickstart: QnA Maker client library for .NET
-
-Get started with the QnA Maker client library for .NET. Follow these steps to install the package and try out the example code for basic tasks.  QnA Maker enables you to power a question-and-answer service from your semi-structured content like FAQ documents, URLs, and product manuals.
-
 Use the QnA Maker client library for .NET to:
 
 * Create a knowledge base
@@ -112,7 +100,7 @@ Next, create an [ApiKeyServiceClientCredentials](https://docs.microsoft.com/dotn
 
 |Environment variable|variable|Example|
 |--|--|--|
-|`QNAMAKER_SUBSCRIPTION_KEY`|`subscription_key`|The key is a 32 character string and is available in the Azure portal, on the QnA Maker resource, on the Quick start page. This is not the same as the prediction endpoint key.|
+|`QNAMAKER_SUBSCRIPTION_KEY`|`subscription_key`|The key is a 32 character string and is available in the Azure portal, on the QnA Maker resource, on the Quickstart page. This is not the same as the prediction endpoint key.|
 |`QNAMAKER_HOST`|`Endpoint`| Your authoring endpoint, in the format of `https://YOUR-RESOURCE-NAME.cognitiveservices.azure.com`, includes your **resource name**. This is not the same URL used to query the prediction endpoint.|
 ||||
 
@@ -203,13 +191,4 @@ The [source code for this quickstart](https://github.com/Azure-Samples/cognitive
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
 * [Portal](../../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
-
-## Next steps
-
-> [!div class="nextstepaction"]
->[Tutorial: Create and answer a KB](../tutorials/create-publish-query-in-portal.md)
-
-* [What is the QnA Maker API?](../Overview/overview.md)
-* [Edit a knowledge base](../how-to/edit-knowledge-base.md)
-* [Get usage analytics](../how-to/get-analytics-knowledge-base.md)
+* [Azure CLI](../../cognitive-services-apis-create-account-cli.md#clean-up-resources)