Merge pull request #278274 from laujan/259625-unified-backward-compatibility-qs-ht

259625 unified backward compatibility qs ht

Author: JamesJBarnett

articles/ai-services/language-service/native-document-support/use-native-documents.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-language
 ms.topic: how-to
-ms.date: 02/21/2024
+ms.date: 06/20/2024
 ms.author: lajanuar
 ---
 
@@ -340,25 +340,28 @@ For this project, you need a **source document** uploaded to your **source conta
 
   ```json
   {
-   "kind": "ExtractiveSummarization",
-   "parameters": {
+  "tasks": [
+    {
+      "kind": "ExtractiveSummarization",
+      "parameters": {
         "sentenceCount": 6
-    },
-   "analysisInput":{
-        "documents":[
-            {
-          "source":{
-            "location":"{your-source-blob-SAS-URL}"
-          },
-          "targets":
-            {
-              "location":"{your-target-container-SAS-URL}",
-            }
-            }
-        ]
+      }
     }
+  ],
+  "analysisInput": {
+    "documents": [
+      {
+        "source": {
+          "location": "{your-source-blob-SAS-URL}"
+        },
+        "targets": {
+          "location": "{your-target-container-SAS-URL}"
+        }
+      }
+    ]
   }
-  ```
+}
+```
 
 ### Run the POST request
 

articles/ai-services/translator/containers/install-run.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: how-to
-ms.date: 04/19/2024
+ms.date: 06/20/2024
 ms.author: lajanuar
 recommendations: false
 keywords: on-premises, Docker, container, identify
@@ -312,7 +312,7 @@ The following example shows the formatting for the `docker run` command with pla
 |:-------------|:-------|:---:|
 | `[image]` | The container image you want to use. | `mcr.microsoft.com/azure-cognitive-services/translator/text-translation` |
 | `{LICENSE_MOUNT}` | The path where the license is downloaded, and mounted.  | `/host/license:/path/to/license/directory` |
- | `{MODEL_MOUNT_PATH}`| The path where the machine translation models are downloaded, and mounted. Your directory structure must be formatted as **/usr/local/models** | `/host/translator/models:/usr/local/models`|
+| `{MODEL_MOUNT_PATH}`| The path where the machine translation models are downloaded, and mounted. Your directory structure must be formatted as **/usr/local/models** | `/host/translator/models:/usr/local/models`|
 | `{ENDPOINT_URI}` | The endpoint for authenticating your service request. You can find it on your resource's **Key and endpoint** page, in the Azure portal. | `https://<your-custom-subdomain>.cognitiveservices.azure.com` |
 | `{API_KEY}` | The key for your Text Translation resource. You can find it on your resource's **Key and endpoint** page, in the Azure portal. |`{string}`|
 | `{LANGUAGES_LIST}` | List of language codes separated by commas. It's mandatory to have English (en) language as part of the list.| `en`, `fr`, `it`, `zu`, `uk` |
@@ -477,15 +477,15 @@ If you installed Docker Desktop CLI, it includes Docker compose and its prerequi
           image:  mcr.microsoft.com/azure-cognitive-services/textanalytics/language:latest
           environment:
               - EULA=accept
-              - billing={TRANSLATOR_ENDPOINT_URI}
-              - apiKey={TRANSLATOR_KEY}
+              - billing={LANGUAGE_RESOURCE_ENDPOINT_URI}
+              - apiKey={LANGUAGE_RESOURCE_KEY}
         azure-ai-read:
           container_name: azure-ai-read
           image:  mcr.microsoft.com/azure-cognitive-services/vision/read:latest
           environment:
               - EULA=accept
-              - billing={TRANSLATOR_ENDPOINT_URI}
-              - apiKey={TRANSLATOR_KEY}
+              - billing={COMPUTER_VISION_ENDPOINT_URI}
+              - apiKey={COMPUTER_VISION_KEY}
     ```
 
 1. Open a terminal navigate to the `container-environment` folder, and start the containers with the following `docker-compose` command:

articles/ai-services/translator/document-translation/document-sdk-overview.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-python
 ms.topic: conceptual
-ms.date: 05/21/2024
+ms.date: 06/19/2024
 ms.author: lajanuar
 recommendations: false
 ---
@@ -26,9 +26,9 @@ Document Translation is a cloud-based REST API feature of the Azure AI Translato
 Document Translation SDK supports the following programming languages:
 
 | Language → SDK version | Package|Client library| Supported API version|
-|:----------------------:|:----------|:----------|:-------------|
+|:----------------------|:----------|:----------|:-------------|
 |🆕 [.NET/C# → 2.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Document/2.0.0-beta.1/index.html)| [NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Document/2.0.0-beta.1) | [Azure SDK for .NET](/dotnet/api/overview/azure/ai.translation.document-readme?branch=main&view=azure-dotnet-preview&preserve-view=true) | Document Translation `api-version=2024-05-01`|
-|🆕 [Python → 1.1.0b1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.1.0b1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.1.0b1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python&preserve-view=true)|Document Translation `api-version=2024-05-01`|
+|🆕 [Python → 1.1.0b1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.1.0b1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.1.0b1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python-preview&preserve-view=true)|Document Translation `api-version=2024-05-01`|
 
 ## Changelog and release history
 
@@ -50,11 +50,11 @@ This section provides a version-based description of Document Translation featur
 **Version 1.1.0b1** </br>
 **2024-05-07**
 
-##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/CHANGELOG.md)
+##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/CHANGELOG.md)
 
-##### [README](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/README.md)
+##### [README](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples/README.md)
 
-##### [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/samples)
+##### [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples)
 
 ---
 
@@ -77,7 +77,7 @@ Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1
 ### [Python](#tab/python)
 
 ```python
-pip install azure-ai-translation-document==1.0.0
+pip install azure-ai-translation-document==1.1.0b1
 ```
 
 ---
@@ -107,6 +107,8 @@ from azure.core.credentials import AzureKeyCredential
 
 Create an instance of the `DocumentTranslationClient` object to interact with the Document Translation SDK, and then call methods on that client object to interact with the service. The `DocumentTranslationClient` is the primary interface for using the Document Translation client library. It provides both synchronous and asynchronous methods to perform operations.
 
+***Asynchronous batch translation***
+
 ```csharp
 private static readonly string endpoint = "<your-custom-endpoint>";
 private static readonly string key = "<your-key>";
@@ -115,15 +117,37 @@ DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoin
 
 ```
 
+***Synchronous single document translation***
+
+```csharp
+private static readonly string endpoint = "<your-custom-endpoint>";
+private static readonly string key = "<your-key>";
+
+SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
+
+```
+
 ### [Python](#tab/python)
 
 Create an instance of the `DocumentTranslationClient` object to interact with the Document Translation SDK, and then call methods on that client object to interact with the service. The `DocumentTranslationClient` is the primary interface for using the Document Translation client library. It provides both synchronous and asynchronous methods to perform operations.
 
+***Asynchronous batch translation***
+
+```python
+  endpoint = "<endpoint>"
+  key = "<apiKey>"
+
+  client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
+
+```
+
+***Synchronous single document translation***
+
 ```python
-endpoint = "<endpoint>"
-key = "<apiKey>"
+  endpoint = "<endpoint>"
+  key = "<apiKey>"
 
-client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
+  client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))
 
 ```
 
@@ -133,7 +157,9 @@ client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))
 
 ### [C#/.NET](#tab/csharp)
 
-The Document Translation interface requires the following input:
+***Asynchronous batch translation***
+
+Document Translation batch interfaces require the following input:
 
 1. Upload your files to an Azure Blob Storage source container (sourceUri).
 1. Provide a target container where the translated documents can be written (targetUri).
@@ -148,9 +174,15 @@ string targetLanguage = "<target-language-code>";
 DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)
 ```
 
+***Synchronous single document translation***
+
+[Single document translation](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/translation/Azure.AI.Translation.Document/samples/Sample5_SynchronousTranslation.md)
+
 ### [Python](#tab/python)
 
-The Document Translation interface requires the following input:
+***Asynchronous batch translation***
+
+Document Translation batch interfaces require the following input:
 
 1. Upload your files to an Azure Blob Storage source container (sourceUri).
 1. Provide a target container where the translated documents can be written (targetUri).
@@ -166,6 +198,10 @@ result = poller.result()
 
 ```
 
+***Synchronous single document translation***
+
+[Single document translation](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.1.0b1/sdk/translation/azure-ai-translation-document/samples/sample_single_document_translation.py)
+
 ---
 
 ## Help options