From e94e5e743c43fed6eb2159f2e880b13177d1b5ec Mon Sep 17 00:00:00 2001
From: Shawn Fang <45607042+mssfang@users.noreply.github.com>
Date: Fri, 5 Jun 2020 23:14:40 -0700
Subject: [PATCH] Update readme for TA, after release review meeting (#11754)
- update the README based on the feedback, fixes: #11752, fixes: #11825, fixes: #6765
---
eng/.docsettings.yml | 1 +
eng/jacoco-test-coverage/pom.xml | 2 +-
eng/versioning/version_client.txt | 2 +-
.../ms-azure-cs-textanalytics/README.md | 22 +++++
.../azure-ai-textanalytics/CHANGELOG.md | 4 +-
.../azure-ai-textanalytics/README.md | 90 +++++++------------
.../azure-ai-textanalytics/pom.xml | 2 +-
.../src/samples/README.md | 85 +++++++++---------
8 files changed, 101 insertions(+), 107 deletions(-)
create mode 100644 sdk/cognitiveservices/ms-azure-cs-textanalytics/README.md
diff --git a/eng/.docsettings.yml b/eng/.docsettings.yml
index d2552429a5e1..4de8af5f9a03 100644
--- a/eng/.docsettings.yml
+++ b/eng/.docsettings.yml
@@ -116,6 +116,7 @@ known_content_issues:
- ['sdk/batch/microsoft-azure-batch/README.md', '#3113']
- ['sdk/boms/azure-sdk-bom/README.md', '#3113']
- ['sdk/core/README.md', '#3113']
+ - ['sdk/cognitiveservices/ms-azure-cs-textanalytics/README.md', '#3113']
- ['sdk/cosmos/changelog/README.md', '#3113']
- ['sdk/cosmos/faq/README.md', '#3113']
- ['sdk/cosmos/azure-cosmos-benchmark/README.md', '#3113']
diff --git a/eng/jacoco-test-coverage/pom.xml b/eng/jacoco-test-coverage/pom.xml
index 95dec08b7629..87b75e49dea2 100644
--- a/eng/jacoco-test-coverage/pom.xml
+++ b/eng/jacoco-test-coverage/pom.xml
@@ -44,7 +44,7 @@
com.azure
azure-ai-textanalytics
- 1.0.0-beta.6
+ 1.0.0
com.azure
diff --git a/eng/versioning/version_client.txt b/eng/versioning/version_client.txt
index d3bd851eca87..9179c5727f92 100644
--- a/eng/versioning/version_client.txt
+++ b/eng/versioning/version_client.txt
@@ -5,7 +5,7 @@ com.azure:azure-sdk-all;1.0.0;1.0.0
com.azure:azure-sdk-parent;1.6.0;1.6.0
com.azure:azure-client-sdk-parent;1.7.0;1.7.0
com.azure:azure-ai-formrecognizer;1.0.0-beta.2;1.0.0-beta.3
-com.azure:azure-ai-textanalytics;1.0.0-beta.5;1.0.0-beta.6
+com.azure:azure-ai-textanalytics;1.0.0-beta.5;1.0.0
com.azure:azure-core;1.5.0;1.6.0-beta.1
com.azure:azure-core-amqp;1.1.2;1.2.0-beta.1
com.azure:azure-core-http-jdk-httpclient;1.0.0-beta.1;1.0.0-beta.1
diff --git a/sdk/cognitiveservices/ms-azure-cs-textanalytics/README.md b/sdk/cognitiveservices/ms-azure-cs-textanalytics/README.md
new file mode 100644
index 000000000000..7780982af072
--- /dev/null
+++ b/sdk/cognitiveservices/ms-azure-cs-textanalytics/README.md
@@ -0,0 +1,22 @@
+## Microsoft Azure Text Analytics Client SDK library for Java
+
+**NOTE:** This is a legacy version that works with the V2.1 version of the service API. For the new set of libraries
+that support newer service versions please see
+[azure-ai-textanalytics](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/textanalytics/azure-ai-textanalytics).
+
+This is the Microsoft Azure Cognitive Services Text Analytics Client
+Library.
+
+## Usage
+
+For code examples, see [Cognitive Services Text
+Analytics](https://docs.microsoft.com/java/api/overview/azure/cognitiveservices/client/textanalytics?view=azure-java-stable)
+on docs.microsoft.com.
+
+## Provide Feedback
+
+If you encounter any bugs or have suggestions, please file an issue in
+the [Issues](https://github.com/Azure/azure-sdk-for-java/issues)
+section of the project.
+
+
diff --git a/sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md b/sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md
index 76378e8bcb46..c57b2b8b6364 100644
--- a/sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md
+++ b/sdk/textanalytics/azure-ai-textanalytics/CHANGELOG.md
@@ -1,7 +1,7 @@
# Release History
-## 1.0.0-beta.6 (Unreleased)
-
+## 1.0.0 (2020-06-09)
+- First stable release of `azure-ai-textanalytics`.
## 1.0.0-beta.5 (2020-05-27)
**New features**
diff --git a/sdk/textanalytics/azure-ai-textanalytics/README.md b/sdk/textanalytics/azure-ai-textanalytics/README.md
index 08fc5cb0746e..fd1cb6b396c2 100644
--- a/sdk/textanalytics/azure-ai-textanalytics/README.md
+++ b/sdk/textanalytics/azure-ai-textanalytics/README.md
@@ -17,19 +17,6 @@ and includes six main functions:
- [Azure Subscription][azure_subscription]
- [Cognitive Services or Text Analytics account][text_analytics_account] to use this package.
-### Include the Package
-**Note:** This version targets Azure Text Analytics service API version v3.0.
-
-[//]: # ({x-version-update-start;com.azure:azure-ai-textanalytics;current})
-```xml
-
- com.azure
- azure-ai-textanalytics
- 1.0.0-beta.5
-
-```
-[//]: # ({x-version-update-end})
-### Authenticate the client
#### Create a Cognitive Services or Text Analytics resource
Text Analytics supports both [multi-service and single-service access][service_access]. Create a Cognitive Services
resource if you plan to access multiple cognitive services under a single endpoint/key. For Text Analytics access only,
@@ -59,13 +46,28 @@ az cognitiveservices account create \
--location westus2 \
--yes
```
+
+### Include the Package
+**Note:** This version targets Azure Text Analytics service API version v3.0.
+
+[//]: # ({x-version-update-start;com.azure:azure-ai-textanalytics;current})
+```xml
+
+ com.azure
+ azure-ai-textanalytics
+ 1.0.0
+
+```
+[//]: # ({x-version-update-end})
+
+### Authenticate the client
In order to interact with the Text Analytics service, you will need to create an instance of the Text Analytics client,
both the asynchronous and synchronous clients can be created by using `TextAnalyticsClientBuilder` invoking `buildClient()`
creates a synchronous client while `buildAsyncClient()` creates its asynchronous counterpart.
You will need an **endpoint** and either a **key** or **AAD TokenCredential** to instantiate a client object.
-##### Looking up the endpoint
+#### Looking up the endpoint
You can find the **endpoint** for your Text Analytics resource in the [Azure Portal][azure_portal] under the "Keys and Endpoint",
or [Azure CLI][azure_cli_endpoint].
```bash
@@ -73,7 +75,7 @@ or [Azure CLI][azure_cli_endpoint].
az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "endpoint"
```
-##### Create a Text Analytics client with key credential
+#### Create a Text Analytics client with key credential
Once you have the value for the [key][key], provide it as a string to the [AzureKeyCredential][azure_key_credential].
This can be found in the [Azure Portal][azure_portal] under the "Keys and Endpoint" section in your created Text Analytics
resource or by running the following Azure CLI command:
@@ -102,7 +104,7 @@ TextAnalyticsClient textAnalyticsClient = new TextAnalyticsClientBuilder()
credential.update("{new_key}");
```
-##### Create a Text Analytics client with Azure Active Directory credential
+#### Create a Text Analytics client with Azure Active Directory credential
Azure SDK for Java supports an Azure Identity package, making it easy to get credentials from Microsoft identity
platform.
@@ -140,7 +142,7 @@ TextAnalyticsAsyncClient textAnalyticsClient = new TextAnalyticsClientBuilder()
```
## Key concepts
-### Client
+### Text Analytics client
The Text Analytics client library provides a [TextAnalyticsClient][text_analytics_sync_client] and
[TextAnalyticsAsyncClient][text_analytics_async_client] to do analysis on batches of documents. It provides both synchronous and
asynchronous operations to access a specific use of Text Analytics, such as language detection or key phrase extraction.
@@ -177,38 +179,6 @@ version of the operation and statistics of the batch documents.
**Note**: It is recommended to use the batch methods when working on production environments as they allow you to send one
request with multiple documents. This is more performant than sending a request per each document.
-The following are types of text analysis that the service offers:
-
-1. [Sentiment Analysis][sentiment_analysis]
-
- Use sentiment analysis to find out what customers think of your brand or topic by analyzing raw text for clues about positive or negative sentiment.
- The returned scores represent the model's confidence that the text is either positive, negative, or neutral. Higher values signify higher confidence.
- Sentiment analysis returns scores and labels at a document and sentence level.
-
-2. [Named Entity Recognition][named_entity_recognition]
-
- Use named entity recognition (NER) to identify different entities in text and categorize them into pre-defined classes, or types.
- Entity recognition in the client library provides three different methods depending on what you are interested in.
- * `recognizeEntities()` can be used to identify and categorize entities in your text as people, places, organizations, date/time, quantities, percentages, currencies, and more.
- * `recognizeLinkedEntities()` can be used to identify and disambiguate the identity of an entity found in text (For example, determining whether
- "Mars" is being used as the planet or as the Roman god of war). This process uses Wikipedia as the knowledge base to which recognized entities are linked.
-
- See a full list of [Named Entity Recognition Types][named_entity_recognition_types].
-
-3. [Language Detection][language_detection]
-
- Detect the language of the document and report a single language code for every document submitted on the request.
- The language code is paired with a score indicating the strength of the score.
- A wide range of languages, variants, dialects, and some regional/cultural languages are supported -
- see [supported languages][supported_languages] for full details.
-
-4. [Key Phrase Extraction][key_phrase_extraction]
-
- Extract key phrases to quickly identify the main points in text.
- For example, for the document "The food was delicious and there were wonderful staff", the main talking points returned: "food" and "wonderful staff".
-
-See [Language and regional support][language_regional_support] for what is currently available for each operation.
-
## Examples
The following sections provide several code snippets covering some of the most common text analytics tasks, including:
@@ -394,19 +364,19 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
[service_access]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
[service_input_limitation]: https://docs.microsoft.com/azure/cognitive-services/text-analytics/overview#data-limits
[sentiment_analysis]: https://docs.microsoft.com/azure/cognitive-services/text-analytics/how-tos/text-analytics-how-to-sentiment-analysis
-[source_code]: src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/textanalytics/azure-ai-textanalytics/src
[supported_languages]: https://docs.microsoft.com/azure/cognitive-services/text-analytics/language-support#language-detection
[text_analytics_account]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
-[text_analytics_async_client]: src/main/java/com/azure/ai/textanalytics/TextAnalyticsAsyncClient.java
-[text_analytics_sync_client]: src/main/java/com/azure/ai/textanalytics/TextAnalyticsClient.java
+[text_analytics_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/main/java/com/azure/ai/textanalytics/TextAnalyticsAsyncClient.java
+[text_analytics_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/main/java/com/azure/ai/textanalytics/TextAnalyticsClient.java
[wiki_identity]: https://github.com/Azure/azure-sdk-for-java/wiki/Identity-and-Authentication
-[LogLevels]: ../../core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
-
-[samples_readme]: src/samples/README.md
-[detect_language_sample]: src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocuments.java
-[analyze_sentiment_sample]: src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocuments.java
-[extract_key_phrases_sample]: src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocuments.java
-[recognize_entities_sample]: src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocuments.java
-[recognize_linked_entities_sample]: src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocuments.java
+[LogLevels]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
+
+[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md
+[detect_language_sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocuments.java
+[analyze_sentiment_sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocuments.java
+[extract_key_phrases_sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocuments.java
+[recognize_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocuments.java
+[recognize_linked_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocuments.java

diff --git a/sdk/textanalytics/azure-ai-textanalytics/pom.xml b/sdk/textanalytics/azure-ai-textanalytics/pom.xml
index ec40ef252b93..b4bf26f17985 100644
--- a/sdk/textanalytics/azure-ai-textanalytics/pom.xml
+++ b/sdk/textanalytics/azure-ai-textanalytics/pom.xml
@@ -13,7 +13,7 @@
com.azure
azure-ai-textanalytics
- 1.0.0-beta.6
+ 1.0.0
Microsoft Azure client library for Text Analytics
This package contains the Microsoft Azure Cognitive Services Text Analytics SDK.
diff --git a/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md b/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md
index 7bb2213f8954..b38caff110de 100644
--- a/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md
+++ b/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md
@@ -4,7 +4,8 @@ languages:
- java
products:
- azure
- - azure-cognitive-service
+ - azure-cognitive-services
+ - azure-text-analytics
---
# Azure Text Analytics client library for Java Samples
@@ -31,8 +32,8 @@ The following sections provide several code snippets covering some of the most c
- [Extract key phrases in a document with asynchronous client][async_sample_key_phrases]
- [Analyze sentiment in a document][sample_sentiment]
- [Analyze sentiment in a document with asynchronous client][async_sample_sentiment]
-- [Rotate API key][sample_rotate_key]
-- [Rotate API key with asynchronous client][async_sample_rotate_key]
+- [Rotate key credential][sample_rotate_key]
+- [Rotate key credential with asynchronous client][async_sample_rotate_key]
Batch Samples:
- [Detect language for a batch of documents][sample_detect_language_batch]
@@ -66,46 +67,46 @@ See [Next steps][SDK_README_NEXT_STEPS].
This project welcomes contributions and suggestions. Find [more contributing][SDK_README_CONTRIBUTING] details here.
-[KEYS_SDK_README]: ../../README.md
-[SDK_README_CONTRIBUTING]: ../../README.md#contributing
-[SDK_README_GETTING_STARTED]: ../../README.md#getting-started
-[SDK_README_TROUBLESHOOTING]: ../../README.md#troubleshooting
-[SDK_README_KEY_CONCEPTS]: ../../README.md#key-concepts
-[SDK_README_DEPENDENCY]: ../../README.md#adding-the-package-to-your-product
-[SDK_README_NEXT_STEPS]: ../../README.md#next-steps
+[KEYS_SDK_README]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md
+[SDK_README_CONTRIBUTING]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#contributing
+[SDK_README_GETTING_STARTED]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#getting-started
+[SDK_README_TROUBLESHOOTING]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#troubleshooting
+[SDK_README_KEY_CONCEPTS]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#key-concepts
+[SDK_README_DEPENDENCY]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#adding-the-package-to-your-product
+[SDK_README_NEXT_STEPS]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/README.md#next-steps
-[async_sample_detect_language]: java/com/azure/ai/textanalytics/DetectLanguageAsync.java
-[async_sample_detect_language_batch]: java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocumentsAsync.java
-[async_sample_detect_language_batch_convenience]: java/com/azure/ai/textanalytics/batch/DetectLanguageBatchStringDocumentsAsync.java
-[async_sample_entities]: java/com/azure/ai/textanalytics/RecognizeEntitiesAsync.java
-[async_sample_entities_batch]: java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocumentsAsync.java
-[async_sample_entities_batch_convenience]: java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchStringDocumentsAsync.java
-[async_sample_linked_entities]: java/com/azure/ai/textanalytics/RecognizeLinkedEntitiesAsync.java
-[async_sample_linked_entities_batch]: java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocumentsAsync.java
-[async_sample_linked_entities_batch_convenience]: java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchStringDocumentsAsync.java
-[async_sample_key_phrases]: java/com/azure/ai/textanalytics/ExtractKeyPhrasesAsync.java
-[async_sample_key_phrases_batch]: java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocumentsAsync.java
-[async_sample_key_phrases_batch_convenience]: java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchStringDocumentsAsync.java
-[async_sample_rotate_key]: java/com/azure/ai/textanalytics/RotateApiKeyAsync.java
-[async_sample_sentiment]: java/com/azure/ai/textanalytics/AnalyzeSentimentAsync.java
-[async_sample_sentiment_batch]: java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocumentsAsync.java
-[async_sample_sentiment_batch_convenience]: java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchStringDocumentsAsync.java
+[async_sample_detect_language]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/DetectLanguageAsync.java
+[async_sample_detect_language_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocumentsAsync.java
+[async_sample_detect_language_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchStringDocumentsAsync.java
+[async_sample_entities]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RecognizeEntitiesAsync.java
+[async_sample_entities_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocumentsAsync.java
+[async_sample_entities_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchStringDocumentsAsync.java
+[async_sample_linked_entities]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RecognizeLinkedEntitiesAsync.java
+[async_sample_linked_entities_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocumentsAsync.java
+[async_sample_linked_entities_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchStringDocumentsAsync.java
+[async_sample_key_phrases]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/ExtractKeyPhrasesAsync.java
+[async_sample_key_phrases_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocumentsAsync.java
+[async_sample_key_phrases_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchStringDocumentsAsync.java
+[async_sample_rotate_key]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RotateAzureKeyCredentialAsync.java
+[async_sample_sentiment]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/AnalyzeSentimentAsync.java
+[async_sample_sentiment_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocumentsAsync.java
+[async_sample_sentiment_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchStringDocumentsAsync.java
-[sample_detect_language]: java/com/azure/ai/textanalytics/DetectLanguage.java
-[sample_detect_language_batch]: java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocuments.java
-[sample_detect_language_batch_convenience]: java/com/azure/ai/textanalytics/batch/DetectLanguageBatchStringDocuments.java
-[sample_entities]: java/com/azure/ai/textanalytics/RecognizeEntities.java
-[sample_entities_batch]: java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocuments.java
-[sample_entities_batch_convenience]: java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchStringDocuments.java
-[sample_linked_entities]: java/com/azure/ai/textanalytics/RecognizeLinkedEntities.java
-[sample_linked_entities_batch]: java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocuments.java
-[sample_linked_entities_batch_convenience]: java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchStringDocuments.java
-[sample_key_phrases]: java/com/azure/ai/textanalytics/ExtractKeyPhrases.java
-[sample_key_phrases_batch]: java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocuments.java
-[sample_key_phrases_batch_convenience]: java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchStringDocuments.java
-[sample_rotate_key]: java/com/azure/ai/textanalytics/RotateApiKey.java
-[sample_sentiment]: java/com/azure/ai/textanalytics/AnalyzeSentiment.java
-[sample_sentiment_batch]: java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocuments.java
-[sample_sentiment_batch_convenience]: java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchStringDocuments.java
+[sample_detect_language]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/DetectLanguage.java
+[sample_detect_language_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocuments.java
+[sample_detect_language_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchStringDocuments.java
+[sample_entities]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RecognizeEntities.java
+[sample_entities_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocuments.java
+[sample_entities_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchStringDocuments.java
+[sample_linked_entities]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RecognizeLinkedEntities.java
+[sample_linked_entities_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocuments.java
+[sample_linked_entities_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchStringDocuments.java
+[sample_key_phrases]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/ExtractKeyPhrases.java
+[sample_key_phrases_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocuments.java
+[sample_key_phrases_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchStringDocuments.java
+[sample_rotate_key]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/RotateAzureKeyCredential.java
+[sample_sentiment]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/AnalyzeSentiment.java
+[sample_sentiment_batch]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocuments.java
+[sample_sentiment_batch_convenience]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchStringDocuments.java
