Merge pull request #181056 from mrbullwinkle/mrb_11_24_2021_link_updates

[Cognitive Services] Q&A API linking

Author: PRMerger18

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

@@ -23,6 +23,9 @@ To get the predicted answer to a user's question, use the GenerateAnswer API. Wh
 
 You use the [GenerateAnswer API](/rest/api/cognitiveservices/qnamakerruntime/runtime/generateanswer) in your bot or application to query your knowledge base with a user question, to get the best match from the question and answer pairs.
 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the latest question answering APIs consult the [question answering quickstart guide](https://docs.microsoft.com/azure/cognitive-services/language-service/question-answering/quickstart/sdk).
+
 <a name="generateanswer-endpoint"></a>
 
 ## Publish to get GenerateAnswer endpoint

articles/cognitive-services/QnAMaker/How-To/using-prebuilt-api.md

@@ -15,7 +15,10 @@ ms.custom: "devx-track-js, devx-track-csharp"
 
 Prebuilt question answering provides user the capability to answer question over a passage of text  without having to create knowledgebases, maintain question and answer pairs or incurring cost for underutilized infrastructure. This functionality is provided as an API and can be used to meet question and answering needs without having to learn the details about QnA Maker or additional storage.
 
-Given a user query and a block of text/passage the API will return an answer and precise answer (if available). 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the Prebuilt API with the latest release consult the [question answering prebuilt API article](../../language-service/question-answering/how-to/prebuilt.md).
+
+Given a user query and a block of text/passage the API will return an answer and precise answer (if available).
 
 <a name="qna-entity"></a>
 

articles/cognitive-services/QnAMaker/Quickstarts/get-answer-from-knowledge-base-using-url-tool.md

@@ -16,6 +16,9 @@ ms.custom: ignite-fall-2021
 
 [!INCLUDE [Custom question answering](../includes/new-version.md)]
 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the latest question answering APIs consult the [question answering authoring guide](../../language-service/question-answering/how-to/authoring.md).
+
 ::: zone pivot="url-test-tool-curl"
 
 [!INCLUDE [Get answer using cURL](../includes/quickstart-test-tool-curl.md)]

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

@@ -13,9 +13,6 @@ zone_pivot_groups: qnamaker-quickstart
 
 Get started with the QnA Maker client library. Follow these steps to install the package and try out the example code for basic tasks.
 
-> [!NOTE]
-> A newer version of question and answering capability is now available as part of Azure Cognitive Service for Language. For more information see [Azure Cognitive Service for Language Documentation](../../language-service/index.yml). For question answering capabilities within the Language Service, see [Question Answering](../../language-service/question-answering/overview.md).
-
 [!INCLUDE [Custom question answering](../includes/new-version.md)]
 
 ::: zone pivot="rest"

articles/cognitive-services/language-service/question-answering/includes/rest.md

@@ -7,8 +7,12 @@ author: mrbullwinkle
 ms.author: mbullwin
 ms.custom: ignite-fall-2021
 ---
+
 ## Prerequisites
 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the REST API with the latest release consult the [question answering REST API quickstart](https://docs.microsoft.com/azure/cognitive-services/language-service/question-answering/quickstart/sdk?pivots=rest).
+
 * The current version of [cURL](https://curl.haxx.se/). Several command-line switches are used in the quickstarts, which are noted in the [cURL documentation](https://curl.haxx.se/docs/manpage.html).
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
 * Question answering, requires a [Language resource](https://ms.portal.azure.com/?quickstart=true#create/Microsoft.CognitiveServicesTextAnalytics) with the custom question answering feature enabled to generate an API key and endpoint.

articles/cognitive-services/language-service/question-answering/includes/sdk-csharp.md

@@ -22,6 +22,9 @@ Use this quickstart for the question answering client library for .NET to:
 
 ## Prerequisites
 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the C# API with the latest release consult the [question answering C# quickstart](https://docs.microsoft.com/azure/cognitive-services/language-service/question-answering/quickstart/sdk?pivots=programming-language-csharp).
+
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
 * The [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) or current version of [.NET Core](https://dotnet.microsoft.com/download/dotnet-core).
 * Question answering, requires a [Language resource](https://ms.portal.azure.com/?quickstart=true#create/Microsoft.CognitiveServicesTextAnalytics) with the custom question answering feature enabled to generate an API key and endpoint. <!--TODO: Change link-->

articles/cognitive-services/language-service/question-answering/includes/sdk-python.md

@@ -23,6 +23,9 @@ Use this quickstart for the question answering client library for Python to:
 
 ## Prerequisites
 
+> [!NOTE]
+> This documentation does not apply to the latest release. To learn about using the Python API with the latest release consult the [question answering Python quickstart](https://docs.microsoft.com/azure/cognitive-services/language-service/question-answering/quickstart/sdk?pivots=programming-language-python).
+
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
 * [Python 3.x](https://www.python.org/)
 * Question answering, requires a [Language resource](https://ms.portal.azure.com/?quickstart=true#create/Microsoft.CognitiveServicesTextAnalytics) with the custom question answering feature enabled to generate an API key and endpoint.

articles/cognitive-services/language-service/question-answering/tutorials/adding-synonyms.md

@@ -18,7 +18,7 @@ In this tutorial, you learn how to:
 > * Add synonyms to improve the quality of your responses
 > * Evaluate the response quality via the inspect option of the Test pane
 
-This tutorial will show you how you can improve the quality of your responses by using synonyms. 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 [Authoring API](/rest/api/cognitiveservices-qnamaker/QnAMaker4.0/Alterations) to add synonyms for keywords.
+This tutorial will show you how you can improve the quality of your responses by using synonyms. 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 [Authoring API](../how-to/authoring.md) to add synonyms for keywords.
 
 ## Add synonyms using Authoring API