Merge pull request #522 from MicrosoftDocs/main

9/27 11:00 AM IST Publish

Author: Saisang

articles/ai-services/document-intelligence/quickstarts/includes/rest-api.md

@@ -10,7 +10,7 @@ ms.date: 09/09/2024
 ms.author: lajanuar
 ---
 
-<!-- markdownlint-disable MD036 -->
+<!-- markdownlint-disable MD036 -->
 
 :::moniker range="doc-intel-4.0.0"
 | [Document Intelligence REST API](/rest/api/aiservices/operation-groups?view=rest-aiservices-v4.0%20(2024-07-31-preview)&preserve-view=true) | [Supported Azure SDKS](../../sdk-overview-v4-0.md)
@@ -109,7 +109,7 @@ Before you run the cURL command, make the following changes to the [post request
 :::moniker range="doc-intel-4.0.0"
 
 ```bash
-curl -v -i POST "{endpoint}/documentintelligence/documentModels/{modelId}:analyze?api-version=2024-02-29-preview" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: {key}" --data-ascii "{'urlSource': '{your-document-url}'}"
+curl -v -i POST "{endpoint}/documentintelligence/documentModels/{modelId}:analyze?api-version=2024-07-31-preview" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: {key}" --data-ascii "{'urlSource': '{your-document-url}'}"
 ```
 
 :::moniker-end
@@ -140,7 +140,7 @@ You receive a `202 (Success)` response that includes a read-only **Operation-Loc
 
 :::moniker range="doc-intel-4.0.0"
 
-After you call the [`Analyze document`](/rest/api/aiservices/document-models/analyze-document?view=rest-aiservices-2024-02-29-preview&preserve-view=true&branch=docintelligence&tabs=HTTP) API, call the [**Get analyze result**](/rest/api/aiservices/document-models/get-analyze-result?view=rest-aiservices-2024-02-29-preview&preserve-view=true&branch=docintelligence&tabs=HTTP) API to get the status of the operation and the extracted data. Before you run the command, make these changes:
+After you call the [`Analyze document`](/rest/api/aiservices/document-models/analyze-document?view=rest-aiservices-v4.0%20(2024-07-31-preview)&preserve-view=true&tabs=HTTP) API, call the [**Get analyze result**](/rest/api/aiservices/document-models/get-analyze-result?view=rest-aiservices-v4.0%20(2024-07-31-preview)&preserve-view=true&tabs=HTTP) API to get the status of the operation and the extracted data. Before you run the command, make these changes:
 :::moniker-end
 
 :::moniker range="doc-intel-3.1.0"
@@ -165,7 +165,7 @@ After you call the [`Analyze document`](/rest/api/aiservices/document-models/ana
 :::moniker range="doc-intel-4.0.0"
 
 ```bash
-curl -v -X GET "{endpoint}/documentintelligence/documentModels/{modelId}/analyzeResults/{resultId}?api-version=2024-02-29-preview" -H "Ocp-Apim-Subscription-Key: {key}"
+curl -v -X GET "{endpoint}/documentintelligence/documentModels/{modelId}/analyzeResults/{resultId}?api-version=2024-07-31-preview" -H "Ocp-Apim-Subscription-Key: {key}"
 ```
 
 :::moniker-end
@@ -202,7 +202,7 @@ You receive a `200 (Success)` response with JSON output. The first field, `"stat
     "createdDateTime": "2024-03-25T19:31:37Z",
     "lastUpdatedDateTime": "2024-03-25T19:31:43Z",
     "analyzeResult": {
-        "apiVersion": "2024-02-29-preview",
+        "apiVersion": "2024-07-31-preview",
         "modelId": "prebuilt-invoice",
         "stringIndexType": "textElements"...
     ..."pages": [

articles/ai-services/translator/document-translation/reference/start-batch-translation.md

@@ -8,7 +8,7 @@ ms.author: lajanuar
 author: laujan
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 08/23/2024
+ms.date: 09/26/2024
 ---
 
 # Start batch translation
@@ -89,9 +89,6 @@ Request headers are:
       "storageType": "Folder"
     }
   ],
-  "options": {
-    "experimental": true
-  }
 }
 
 ```

articles/ai-services/translator/quickstart-text-sdk.md

@@ -21,11 +21,7 @@ zone_pivot_groups:  programming-languages-set-translator-sdk
 <!-- markdownlint-disable MD036 -->
 <!-- markdownlint-disable MD049 -->
 
-# Quickstart: Azure AI Translator client libraries (preview)
-
-> [!IMPORTANT]
->
-> * The Translator text SDKs are currently available in public preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
+# Quickstart: Azure AI Translator text client libraries 
 
 In this quickstart, get started using the Translator service to [translate text](reference/v3-0-translate.md) using a programming language of your choice. For this project, we recommend using the free pricing tier (F0), while you're learning the technology, and later upgrading to a paid tier for production.
 

articles/ai-services/translator/reference/v3-0-translate.md

@@ -8,7 +8,7 @@ manager: nitinme
 
 ms.service: azure-ai-translator
 ms.topic: reference
-ms.date: 06/06/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 ---
 
@@ -266,11 +266,14 @@ Normally, the Translator service retains profanity that is present in the source
 If you want to avoid getting profanity in the translation, regardless of the presence of profanity in the source text, you can use the profanity filtering option. The option allows you to choose whether you want to see profanity deleted, marked with appropriate tags (giving you the option to add your own post-processing), or with no action taken. The accepted values of `ProfanityAction` are `Deleted`, `Marked`, and `NoAction` (default).
 
 
-| ProfanityAction | Action |
-| --- | --- |
-| `NoAction` | NoAction is the default behavior. Profanity passes from source to target.  <br><br>**Example Source (Japanese)**: 彼はジャッカスです。  <br>**Example Translation (English)**: H&#8203;e's a jack---. |
-| `Deleted` | Profane words are removed from the output without replacement.  <br>  <br>**Example Source (Japanese)**: 彼はジャッカスです。  <br>**Example Translation (English)**: H&#8203;e's a** |
-| `Marked` | A marker replaces the marked word in the output. The marker depends on the `ProfanityMarker` parameter.  <br>  <br>For `ProfanityMarker=Asterisk`, profane words are replaced with `***`:  <br>**Example Source (Japanese)**: 彼はジャッカスです。  <br>**Example Translation (English)**: H&#8203;e's a \\*\\*\\*.  <br>  <br>For `ProfanityMarker=Tag`, profane words are surrounded by XML tags &lt;profanity&gt; and &lt;/profanity&gt;:  <br>**Example Source (Japanese)**: 彼はジャッカスです。  <br>**Example Translation (English)**: H&#8203;e's a &lt;profanity&gt;jack---&lt;/profanity&gt;. |
+| Accepted ProfanityAction value | ProfanityMarker value | Action | Example: Source - Spanish| Example: Target - English|
+|:--|:--|:--|:--|:--|
+| NoAction|  | Default. Same as not setting the option. Profanity passes from source to target. | `Que coche de` \<insert-profane-word> | What a \<insert-profane-word> car  |
+| Marked                | Asterisk              | Asterisks replace profane words (default).                               | `Que coche de` \<insert-profane-word> | What a *** car      |
+| Marked                | Tag                   | Profane words are surrounded by XML tags \<profanity\>...\</profanity>.          | `Que coche de` \<insert-profane-word> | What a \<profanity> \<insert-profane-word> \</profanity> car |
+| Deleted               |                       | Profane words are removed from the output without replacement.                   | `Que coche de` \<insert-profane-word> | What a car        |
+
+In the above examples, **\<insert-profane-word>** is a placeholder for profane words.
 
 For example:
 

articles/ai-services/translator/text-sdk-overview.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-python
 ms.topic: conceptual
-ms.date: 07/08/2024
+ms.date: 09/26/2024
 ms.author: lajanuar
 recommendations: false
 ---
@@ -17,11 +17,7 @@ recommendations: false
 <!-- markdownlint-disable MD001 -->
 <!-- markdownlint-disable MD051 -->
 
-# Azure Text Translation SDK (preview)
-
-> [!IMPORTANT]
->
-> * The Translator text SDKs are currently available in public preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
+# Azure Text Translation SDK
 
 Azure Text Translation is a cloud-based REST API feature of the Azure AI Translator service. The Text Translation API enables quick and accurate source-to-target text translations in real time. The Text Translation software development kit (SDK) is a set of libraries and tools that enable you to easily integrate Text Translation REST API capabilities into your applications. Text Translation SDK is available across programming platforms in C#/.NET, Java, JavaScript, and Python.
 
@@ -31,17 +27,79 @@ Text Translation SDK supports the programming languages and platforms:
 
 | Language → SDK version | Package|Client library| Supported API version|
 |:----------------------:|:----------|:----------|:-------------|
-|[.NET/C# → 1.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Text/1.0.0-beta.1/index.html)|[NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0-beta.1)|[Azure SDK for .NET](/dotnet/api/overview/azure/ai.translation.text-readme?view=azure-dotnet-preview&preserve-view=true)|Translator v3.0|
-|[Java&#x2731; → 1.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-ai-translation-text/1.0.0-beta.1/index.html)|[Maven repository](https://mvnrepository.com/artifact/com.azure/azure-ai-translation-text/1.0.0-beta.1)|[Azure SDK for Java](/java/api/overview/azure/ai-translation-text-readme?view=azure-java-preview&preserve-view=true)|Translator v3.0|
-|[JavaScript → 1.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/javascript/azure-cognitiveservices-translatortext/1.0.0/index.html)|[npm](https://www.npmjs.com/package/@azure-rest/ai-translation-text/v/1.0.0-beta.1)|[Azure SDK for JavaScript](/javascript/api/overview/azure/text-translation?view=azure-node-preview&preserve-view=true) |Translator v3.0 |
-|**Python → 1.0.0b1**|[PyPi](https://pypi.org/project/azure-ai-translation-text/1.0.0b1/)|[Azure SDK for Python](/python/api/azure-ai-translation-text/azure.ai.translation.text?view=azure-python-preview&preserve-view=true) |Translator v3.0|
+|[.NET/C# → 1.0.0](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Text/1.0.0/index.html)|[NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0)|[Azure SDK for .NET](/dotnet/api/overview/azure/ai.translation.text-readme?view=azure-dotnet&preserve-view=true)|Translator v3.0|
+|[Java&#x2731; → 1.0.0](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-ai-translation-text/1.0.0/index.html)|[Maven repository](https://mvnrepository.com/artifact/com.azure/azure-ai-translation-text/1.0.0)|[Azure SDK for Java](/java/api/overview/azure/ai-translation-text-readme?view=azure-java-stable&preserve-view=true)|Translator v3.0|
+|[JavaScript → 1.0.0](https://azuresdkdocs.blob.core.windows.net/$web/javascript/azure-cognitiveservices-translatortext/1.0.0/index.html)|[npm](https://www.npmjs.com/package/@azure-rest/ai-translation-text/v/1.0.0)|[Azure SDK for JavaScript](/javascript/api/overview/azure/text-translation?view=azure-node-preview&preserve-view=true) |Translator v3.0 |
+|[Python → 1.0.1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-text/1.0.1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-text/1.0.1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-text-readme?view=azure-python&preserve-view=true) |Translator v3.0|
 
 &#x2731; The Azure Text Translation SDK for Java is tested and supported on Windows, Linux, and macOS platforms. It isn't tested on other platforms and doesn't support Android deployments.
 
 ## Changelog and release history
 
 This section provides a version-based description of Text Translation feature and capability releases, changes, updates, and enhancements.
 
+#### Translator Text SDK May 2024 GA release
+
+This release includes the following updates:
+
+### [**C#**](#tab/csharp)
+
+* **Version 1.0.0 (2024-05-21)**
+* **Targets Text Translation v3.0**
+* **GA version release**
+
+[**Package (NuGet)**](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0)
+
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/translation/Azure.AI.Translation.Text/CHANGELOG.md#100-2024-05-21)
+
+[**README**](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/translation/Azure.AI.Translation.Text#readme)
+
+[**Samples**](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/translation/Azure.AI.Translation.Text/samples)
+
+### [**Java**](#tab/java)
+
+* **Version 1.0.0 (2024-05-21)**
+* **Targets Text Translation v3.0**
+* **GA version release**
+
+[**Package (MVN)**](https://mvnrepository.com/artifact/com.azure/azure-ai-translation-text/1.0.0)
+
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/CHANGELOG.md#100-2024-05-21)
+
+[**README**](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-text#readme)
+
+[**Samples**](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-text#next-steps)
+
+### [**JavaScript**](#tab/javascript)
+
+* **Version 1.0.0 (2024-05-21)**
+* **Targets Text Translation v3.0**
+* **GA version release**
+
+[**Package (npm)**](https://www.npmjs.com/package/@azure-rest/ai-translation-text/v/1.0.0)
+
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/translation/ai-translation-text-rest/CHANGELOG.md#100-2024-05-21)
+
+[**README**](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/translation/ai-translation-text-rest/README.md)
+
+[**Samples**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/translation/ai-translation-text-rest/samples/v1-beta)
+
+### [**Python**](#tab/python)
+
+* **Version 1.0.0 (2024-05-23)**
+* **Targets Text Translation v3.0**
+* **GA version release**
+
+[**Package (PyPi)**](https://pypi.org/project/azure-ai-translation-text/1.0.1/)
+
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/translation/azure-ai-translation-text/CHANGELOG.md#100-2024-05-23)
+
+[**README**](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/translation/azure-ai-translation-text/README.md)
+
+[**Samples**](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/translation/azure-ai-translation-text/samples)
+
+---
+
 #### Translator Text SDK April 2023 preview release
 
 This release includes the following updates:

articles/ai-services/translator/toc.yml

@@ -30,14 +30,14 @@ items:
   - name: What is Text Translation?
     displayName: features,develop,development,free
     href: text-translation-overview.md
-  - name: 🆕 Text Translation SDK overview (preview)
+  - name: 🆕 Text Translation SDK overview
     displayName: get started,sdk,keys,endpoint
     href: text-sdk-overview.md
   - name: Text Translation REST API guide
     href:  reference/rest-api-guide.md
   - name: Quickstarts
     items:
-    - name: Translator Text SDK (preview)
+    - name: Translator Text SDK
       displayName: get started,sdk,keys,endpoint,headers,c#,go,java,javascript,python,setup
       href: quickstart-text-sdk.md
     - name:  Translator Text REST APIs