[textanalytics] bug bash readme feedback (Azure#22091)

* bug bash feedback for text analytics

* fix wording/formatting

Author: kristapratico

sdk/textanalytics/azure-ai-textanalytics/README.md

@@ -24,19 +24,19 @@ _Azure SDK Python packages support for Python 2.7 is ending 01 January 2022. For
 
 - Python 2.7, or 3.6 or later is required to use this package.
 - You must have an [Azure subscription][azure_subscription] and a
-  [Cognitive Services or Text Analytics resource][ta_or_cs_resource] to use this package.
+  [Cognitive Services or Language resource][ta_or_cs_resource] to use this package.
 
-#### Create a Cognitive Services or Text Analytics resource
+#### Create a Cognitive Services or Language resource
 
 Text Analytics supports both [multi-service and single-service access][multi_and_single_service].
-Create a Cognitive Services resource if you plan to access multiple cognitive services under a single endpoint/key. For Text Analytics access only, create a Text Analytics resource.
+Create a Cognitive Services resource if you plan to access multiple cognitive services under a single endpoint/key. For Text Analytics access only, create a Language resource.
 
 You can create the resource using
 
 **Option 1:** [Azure Portal][azure_portal_create_ta_resource]
 
 **Option 2:** [Azure CLI][azure_cli_create_ta_resource].
-Below is an example of how you can create a Text Analytics resource using the CLI:
+Below is an example of how you can create a Language resource using the CLI:
 
 ```bash
 # Create a new resource group to hold the text analytics resource -
@@ -56,20 +56,19 @@ az cognitiveservices account create \
 ```
 
 Interaction with this service begins with an instance of a [client](#textanalyticsclient "TextAnalyticsClient").
-To create a client object, you will need the cognitive services or text analytics `endpoint` to
+To create a client object, you will need the cognitive services or language `endpoint` to
 your resource and a `credential` that allows you access:
 
 ```python
 from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-text_analytics_client = TextAnalyticsClient(endpoint="https://<region>.api.cognitive.microsoft.com/", credential=credential)
+text_analytics_client = TextAnalyticsClient(endpoint="https://<resource-name>.cognitiveservices.azure.com/", credential=credential)
 ```
 
-Note that if you create a [custom subdomain][cognitive_custom_subdomain]
-name for your resource the endpoint may look different than in the above code snippet.
-For example, `https://<my-custom-subdomain>.cognitiveservices.azure.com/`.
+Note that for some Cognitive Services resources the endpoint might look different from the above code snippet.
+For example, `https://<region>.api.cognitive.microsoft.com/`.
 
 ### Install the package
 
@@ -89,6 +88,8 @@ This table shows the relationship between SDK versions and supported API version
 | 5.1.0 - Latest GA release | 3.0, 3.1 (default) |
 | 5.0.0  | 3.0 |
 
+API version can be selected by passing the [api_version][text_analytics_client] keyword argument into the client.
+For the latest Text Analytics features, consider selecting the most recent preview API version. For production scenarios, the latest GA version is recommended. Setting to an older version may result in reduced feature compatibility.
 
 ### Authenticate the client
 
@@ -105,7 +106,7 @@ az cognitiveservices account show --name "resource-name" --resource-group "resou
 
 #### Get the API Key
 
-You can get the [API key][cognitive_authentication_api_key] from the Cognitive Services or Text Analytics resource in the [Azure Portal][azure_portal_get_endpoint].
+You can get the [API key][cognitive_authentication_api_key] from the Cognitive Services or Language resource in the [Azure Portal][azure_portal_get_endpoint].
 Alternatively, you can use [Azure CLI][azure_cli_endpoint_lookup] snippet below to get the API key of your resource.
 
 `az cognitiveservices account keys list --name "resource-name" --resource-group "resource-group-name"`
@@ -120,7 +121,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-text_analytics_client = TextAnalyticsClient(endpoint="https://<region>.api.cognitive.microsoft.com/", credential=credential)
+text_analytics_client = TextAnalyticsClient(endpoint="https://<resource-name>.cognitiveservices.azure.com/", credential=credential)
 ```
 
 #### Create a TextAnalyticsClient with an Azure Active Directory Credential
@@ -151,7 +152,7 @@ from azure.ai.textanalytics import TextAnalyticsClient
 from azure.identity import DefaultAzureCredential
 
 credential = DefaultAzureCredential()
-text_analytics_client = TextAnalyticsClient(endpoint="https://<my-custom-subdomain>.api.cognitive.microsoft.com/", credential=credential)
+text_analytics_client = TextAnalyticsClient(endpoint="https://<resource-name>.cognitiveservices.azure.com/", credential=credential)
 ```
 
 ## Key concepts
@@ -247,7 +248,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -282,7 +283,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -321,7 +322,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -360,7 +361,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -397,7 +398,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -429,7 +430,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -465,7 +466,7 @@ from azure.core.credentials import AzureKeyCredential
 from azure.ai.textanalytics import TextAnalyticsClient
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -502,7 +503,7 @@ for idx, doc in enumerate(docs):
     print("------------------------------------------")
 ```
 
-Note: The Healthcare Entities Analysis service is available in API version v3.1 and up.
+Note: The Healthcare Entities Analysis service is only available in the Standard pricing tier with API versions v3.1 and up.
 
 ### Multiple Analysis
 
@@ -527,7 +528,7 @@ from azure.ai.textanalytics import (
 )
 
 credential = AzureKeyCredential("<api_key>")
-endpoint="https://<region>.api.cognitive.microsoft.com/"
+endpoint="https://<resource-name>.cognitiveservices.azure.com/"
 
 text_analytics_client = TextAnalyticsClient(endpoint, credential)
 
@@ -614,7 +615,7 @@ logger.setLevel(logging.DEBUG)
 handler = logging.StreamHandler(stream=sys.stdout)
 logger.addHandler(handler)
 
-endpoint = "https://<my-custom-subdomain>.cognitiveservices.azure.com/"
+endpoint = "https://<resource-name>.cognitiveservices.azure.com/"
 credential = DefaultAzureCredential()
 
 # This client will log detailed information about its HTTP sessions, at DEBUG level
@@ -637,7 +638,7 @@ These code samples show common scenario operations with the Azure Text Analytics
 The async versions of the samples (the python sample files appended with `_async`) show asynchronous operations
 with Text Analytics and require Python 3.6 or later.
 
-Authenticate the client with a Cognitive Services/Text Analytics API key or a token credential from [azure-identity][azure_identity]:
+Authenticate the client with a Cognitive Services/Language API key or a token credential from [azure-identity][azure_identity]:
 
 - [sample_authentication.py][sample_authentication] ([async version][sample_authentication_async])