Merge branch 'may-ta-v3' of https://github.com/aahill/azure-docs-pr into may-ta-v3

Author: aahill

articles/cognitive-services/text-analytics/how-tos/text-analytics-how-to-keyword-extraction.md

@@ -14,7 +14,7 @@ ms.author: aahi
 
 # Example: How to extract key phrases using Text Analytics
 
-The [Key Phrase Extraction API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c6) evaluates unstructured text, and for each JSON document, returns a list of key phrases.
+The [Key Phrase Extraction API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/KeyPhrases) evaluates unstructured text, and for each JSON document, returns a list of key phrases.
 
 This capability is useful if you need to quickly identify the main points in a collection of documents. For example, given input text "The food was delicious and there were wonderful staff", the service returns the main talking points: "food" and "wonderful staff".
 
@@ -67,7 +67,7 @@ Document size must be 5,120 or fewer characters per document, and you can have u
 
 For information about request definition, see [How to call the Text Analytics API](text-analytics-how-to-call-api.md). The following points are restated for convenience:
 
-+ Create a **POST** request. Review the API documentation for this request: [Key Phrases API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c6).
++ Create a **POST** request. Review the API documentation for this request: [Key Phrases API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/KeyPhrases).
 
 + Set the HTTP endpoint for key phrase extraction by using either a Text Analytics resource on Azure or an instantiated [Text Analytics container](text-analytics-how-to-install-containers.md). You must include `/text/analytics/v3.0/keyPhrases` in the URL. For example: `https://<your-custom-subdomain>.api.cognitiveservices.azure.com/text/analytics/v3.0/keyPhrases`.
 
@@ -76,7 +76,7 @@ For information about request definition, see [How to call the Text Analytics AP
 + In the request body, provide the JSON documents collection you prepared for this analysis.
 
 > [!Tip]
-> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c6) to structure a request and POST it to the service.
+> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/KeyPhrases) to structure a request and POST it to the service.
 
 ## Step 2: Post the request
 
@@ -147,7 +147,7 @@ As noted, the analyzer finds and discards non-essential words, and it keeps sing
 
 In this article, you learned concepts and workflow for key phrase extraction by using Text Analytics in Cognitive Services. In summary:
 
-+ [Key phrase extraction API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c6) is available for selected languages.
++ [Key phrase extraction API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/KeyPhrases) is available for selected languages.
 + JSON documents in the request body include an ID, text, and language code.
 + POST request is to a `/keyphrases` endpoint, using a personalized [access key and an endpoint](../../cognitive-services-apis-create-account.md#get-the-keys-for-your-resource) that is valid for your subscription.
 + Response output, which consists of key words and phrases for each document ID, can be streamed to any app that accepts JSON, including Microsoft Office Excel and Power BI, to name a few.
@@ -161,4 +161,4 @@ In this article, you learned concepts and workflow for key phrase extraction by
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Text Analytics API](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V2-1/operations/56f30ceeeda5650db055a3c6)
+> [Text Analytics API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-V3-0/)

articles/cognitive-services/text-analytics/how-tos/text-analytics-how-to-language-detection.md

@@ -14,7 +14,7 @@ ms.author: aahi
 
 # Example: Detect language with Text Analytics
 
-The [Language Detection](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c7) feature of the Azure Text Analytics REST API evaluates text input for each document and returns language identifiers with a score that indicates the strength of the analysis.
+The [Language Detection](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages) feature of the Azure Text Analytics REST API evaluates text input for each document and returns language identifiers with a score that indicates the strength of the analysis.
 
 This capability is useful for content stores that collect arbitrary text, where language is unknown. You can parse the results of this analysis to determine which language is used in the input document. The response also returns a score that reflects the confidence of the model. The score value is between 0 and 1.
 
@@ -62,7 +62,7 @@ The document size must be under 5,120 characters per document. You can have up t
 
 For more information on request definition, see [Call the Text Analytics API](text-analytics-how-to-call-api.md). The following points are restated for convenience:
 
-+ Create a POST request. To review the API documentation for this request, see the [Language Detection API](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c7).
++ Create a POST request. To review the API documentation for this request, see the [Language Detection API](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages).
 
 + Set the HTTP endpoint for language detection. Use either a Text Analytics resource on Azure or an instantiated [Text Analytics container](text-analytics-how-to-install-containers.md). You must include `/text/analytics/v3.0/languages` in the URL. For example: `https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/v3.0/languages`.
 
@@ -71,7 +71,7 @@ For more information on request definition, see [Call the Text Analytics API](te
 + In the request body, provide the JSON documents collection you prepared for this analysis.
 
 > [!Tip]
-> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c7) to structure a request and POST it to the service.
+> Use [Postman](text-analytics-how-to-call-api.md) or open the **API testing console** in the [documentation](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages) to structure a request and POST it to the service.
 
 ## Step 2: POST the request
 
@@ -181,7 +181,7 @@ The service now has additional context to make a better judgment:
                     {
                         "name": "English",
                         "iso6391Name": "en",
-                        "ConfidenceScore": 1
+                        "confidenceScore": 1
                     }
                 ]
             },
@@ -191,7 +191,7 @@ The service now has additional context to make a better judgment:
                     {
                         "name": "French",
                         "iso6391Name": "fr",
-                        "ConfidenceScore": 1
+                        "confidenceScore": 1
                     }
                 ]
             }
@@ -209,7 +209,7 @@ If the analyzer can't parse the input, it returns `(Unknown)`. An example is if
             {
                 "name": "(Unknown)",
                 "iso6391Name": "(Unknown)",
-                "ConfidenceScore": "NaN"
+                "confidenceScore": "NaN"
             }
         ]
     }
@@ -245,7 +245,7 @@ The resulting output consists of the predominant language, with a score of less
             {
               "name": "Spanish",
               "iso6391Name": "es",
-              "Confidencescore": 0.9375
+              "confidencescore": 0.94
             }
           ]
         }
@@ -258,7 +258,7 @@ The resulting output consists of the predominant language, with a score of less
 
 In this article, you learned concepts and workflow for language detection by using Text Analytics in Azure Cognitive Services. The following points were explained and demonstrated:
 
-+ [Language detection](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1/operations/56f30ceeeda5650db055a3c7) is available for a wide range of languages, variants, dialects, and some regional or cultural languages.
++ [Language detection](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages) is available for a wide range of languages, variants, dialects, and some regional or cultural languages.
 + JSON documents in the request body include an ID and text.
 + The POST request is to a `/languages` endpoint by using a personalized [access key and an endpoint](../../cognitive-services-apis-create-account.md#get-the-keys-for-your-resource) that's valid for your subscription.
 + Response output consists of language identifiers for each document ID. The output can be streamed to any app that accepts JSON. Example apps include Excel and Power BI, to name a few.

articles/cognitive-services/text-analytics/includes/text-analytics-api-references.md

@@ -13,5 +13,5 @@ ms.author: assafi
 
 > [!Tip]
 > For detailed API technical documentation and to see it in action, use the following links. You can also send POST requests from the built-in API test console. No setup is required, simply paste your resource key and JSON documents into the request:
-> - Latest stable API - [v2.1](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v2-1)
-> - Latest preview API - [v3.0-Preview.1](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0-Preview-1)
+> - Latest stable API - [v3.0](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0)
+> - Latest preview API - [v3.1-Preview.1](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-1-Preview-1)

articles/cognitive-services/text-analytics/includes/v3-region-availability.md

@@ -12,6 +12,6 @@ ms.author: aahi
 ---
 
 > [!IMPORTANT]
-> Text Analytics API v3 is not available in the following regions: Central India, UAE North, South Africa North, China North 2, China East 2.
+> Text Analytics API v3 is not available in the following regions: Central India, UAE North, South Africa North, China North 2, China East.
 
 

articles/cognitive-services/text-analytics/language-support.md

@@ -14,7 +14,7 @@ ms.author: aahi
 # Text Analytics API v3 language support 
 
 > [!IMPORTANT]
-> Version 3.x of the Text Analytics API is currently unavailable in the following regions: Central India, UAE North, South Africa North, China North 2, China East 2.
+> Version 3.x of the Text Analytics API is currently unavailable in the following regions: Central India, UAE North, South Africa North, China North 2, China East.
 
 
 #### [Sentiment Analysis](#tab/sentiment-analysis)
@@ -51,8 +51,8 @@ ms.author: aahi
 #### [Named Entity Recognition (NER)](#tab/named-entity-recognition)
 
 > [!NOTE]
-> * NER v3 currently only supports the English language. If you call NER v3 with a different language,  The API will return v2.1 results, provided the language is supported in version 2.1.
-> * v2.1 only returns the full set of available entities for the English, Chinese-Simplified, French, German, and Spanish languages. the "Person", "Location" and "Organization" entities are returned for other languages.
+> * NER v3 currently only supports the English language. If you call NER v3 with a different language, the API will return v2.1 results, provided the language is supported in version 2.1.
+> * v2.1 only returns the full set of available entities for the English, Chinese-Simplified, French, German, and Spanish languages.  The "Person", "Location" and "Organization" entities are returned for the other supported languages.
 
 | Language               | Language code | v2.1 support | v3 support | Starting with v3 model version: |       Notes        |
 |:-----------------------|:-------------:|:----------:|:----------:|:-------------------------------:|:------------------:|

articles/cognitive-services/text-analytics/quickstarts/text-analytics-sdk.md

@@ -27,7 +27,7 @@ Use the Text Analytics client library to perform:
 ::: zone pivot="programming-language-csharp"
 
 > [!IMPORTANT]
-> * The latest preview version of the Text Analytics API is `3.0-preview`, which includes a public preview for improved [Sentiment Analysis](../how-tos/text-analytics-how-to-sentiment-analysis.md#sentiment-analysis-versions-and-features) and [Named Entity Recognition (NER)](../how-tos/text-analytics-how-to-entity-linking.md#named-entity-recognition-versions-and-features). The latest stable version is `2.1`.
+> * The latest preview version of the Text Analytics API is `3.1-preview`, which includes a public preview for Opinion Mining [Sentiment Analysis](../how-tos/text-analytics-how-to-sentiment-analysis.md#opinion-mining) and new [Personal (`PII`) domain filter](how-tos/text-analytics-how-to-entity-linking.md#named-entity-recognition-versions-and-features) for protected health information (`PHI`). The latest stable version is `3.0`.
 >    * Be sure to only follow the instructions for the version you are using.
 > * The code in this article uses synchronous methods and un-secured credentials storage for simplicity reasons. For production scenarios, we recommend using the batched asynchronous methods for performance and scalability. See the reference documentation below.
 

articles/cognitive-services/text-analytics/whats-new.md

@@ -23,8 +23,8 @@ The Text Analytics API is updated on an ongoing basis. To stay up-to-date with r
 Text Analysis API v3 is now generally available with the following updates:
 
 * Model version `2020-04-01`
-* Updated [language support](language-support.md) for [sentiment analysis v3](how-tos/text-analytics-how-to-sentiment-analysis.md)
-* Separate endpoint for entity linking 
+* Updated [language support](language-support.md) for [Sentiment Analysis (SA) v3](how-tos/text-analytics-how-to-sentiment-analysis.md)
+* Separate endpoint for Entity Linking 
 * New "Address" entity category in [Named Entity Recognition (NER) v3](how-tos/text-analytics-how-to-entity-linking.md).
 * New subcategories in NER v3:
    * Location - Geographical
@@ -38,7 +38,7 @@ Text Analysis API v3 is now generally available with the following updates:
 
 The following properties in the JSON response have been added:
    * `SentenceText` in Sentiment Analysis
-   * Warnings for each document
+   * `Warnings` for each document 
 
 The names of the following properties in the JSON response have been changed, where applicable:
 
@@ -50,11 +50,17 @@ The names of the following properties in the JSON response have been changed, wh
 [!INCLUDE [v3 region availability](includes/v3-region-availability.md)]
 
 > [!div class="nextstepaction"]
-> [Learn more about Text Analytics API v3](https://westus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages)
+> [Learn more about Text Analytics API v3](https://westus2.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-0/operations/Languages)
 
 ### Text Analytics API v3.1 Public Preview
-   * New sentiment analysis feature - [Opinion Mining](how-tos/text-analytics-how-to-sentiment-analysis.md#opinion-mining)
-   * New [NER domain filter](how-tos/text-analytics-how-to-entity-linking.md#named-entity-recognition-versions-and-features) for personal (`PII`) and protected health (`PHI`) information.
+   * New Sentiment Analysis feature - [Opinion Mining](how-tos/text-analytics-how-to-sentiment-analysis.md#opinion-mining)
+   * New [Personal (`PII`) domain filter](how-tos/text-analytics-how-to-entity-linking.md#named-entity-recognition-versions-and-features) for protected health information (`PHI`).
+   * New Personal (`PII`) categories:
+      * International Classification of Diseases (ICD-9-CM)
+      * International Classification of Diseases (ICD-10-CM)
+
+> [!div class="nextstepaction"]
+> [Learn more about Text Analytics API v3.1 Preview](https://westcentralus.dev.cognitive.microsoft.com/docs/services/TextAnalytics-v3-1-preview-1/operations/Languages)
 
 ## February 2020