Merge pull request #264420 from laujan/181271-dt-synchronous-asynchronous

181271 dt synchronous asynchronous

Author: American-Dipper

articles/ai-services/.openpublishing.redirection.ai-services-from-applied.json

@@ -625,7 +625,17 @@
       "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-rest-api-sdk.md",
       "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/rest-api-sdk.md",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/quickstarts/document-translation-sdk.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/quickstarts/asynchronous-sdk",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/quickstarts/document-translation-rest-api.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/quickstarts/asynchronous-rest-api",
+      "redirect_document_id": true
     }
-    
+
   ]
 }

articles/ai-services/translator/custom-translator/concepts/sentence-alignment.md

@@ -5,7 +5,7 @@ description: During the training execution, sentences present in parallel docume
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
-ms.date: 07/18/2023
+ms.date: 02/12/2024
 ms.author: lajanuar
 ms.topic: conceptual
 ms.custom: cogserv-non-critical-translator
@@ -22,21 +22,21 @@ able to pair as the Aligned Sentences in each of the data sets.
 
 Custom Translator learns translations of sentences one sentence at a time. It reads a sentence from the source text, and then the translation of this sentence from the target text. Then it aligns words and phrases in these two sentences to each other. This process enables it to create a map of the words and phrases in one sentence to the equivalent words and phrases in the translation of the sentence. Alignment tries to ensure that the system trains on sentences that are translations of each other.
 
-## Pre-aligned documents
+## Prealigned documents
 
-If you know you have parallel documents, you may override the
-sentence alignment by supplying pre-aligned text files. You can extract all
+If you know you have parallel documents, you can override the
+sentence alignment by supplying prealigned text files. You can extract all
 sentences from both documents into text file, organized one sentence per line,
 and upload with an `.align` extension. The `.align` extension signals Custom
 Translator that it should skip sentence alignment.
 
 For best results, try to make sure that you have one sentence per line in your
- files. Don't have newline characters within a sentence, it will cause poor
+ files. Don't have newline characters within a sentence—it causes poor
 alignments.
 
 ## Suggested minimum number of sentences
 
-For a training to succeed, the table below shows the minimum number of sentences required in each document type. This limitation is a safety net to ensure your parallel sentences contain enough unique vocabulary to successfully train a translation model. The general guideline is having more in-domain parallel sentences of human translation quality should produce higher-quality models.
+For a training to succeed, the following table shows the minimum number of sentences required in each document type. This limitation is a safety net to ensure your parallel sentences contain enough unique vocabulary to successfully train a translation model. The general guideline is having more in-domain parallel sentences of human translation quality should produce higher-quality models.
 
 | Document type   | Suggested minimum sentence count | Maximum sentence count |
 |------------|--------------------------------------------|--------------------------------|

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: 07/18/2023
+ms.date: 02/12/2024
 ms.author: lajanuar
 recommendations: false
 ---
@@ -170,7 +170,7 @@ result = poller.result()
 
 ## Help options
 
-The [Microsoft Q&A](/answers/tags/132/azure-translator) and [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoft-translator) forums are available for the developer community to ask and answer questions about Azure Text Translation and other services. Microsoft monitors the forums and replies to questions that the community has yet to answer.
+The [`Microsoft Q&A`](/answers/tags/132/azure-translator) and [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoft-translator) forums are available for the developer community to ask and answer questions about Azure Text Translation and other services. Microsoft monitors the forums and replies to questions that the community has yet to answer.
 
 > [!TIP]
 > To make sure that we see your Microsoft Q&A question, tag it with **`microsoft-translator`**.
@@ -180,4 +180,4 @@ The [Microsoft Q&A](/answers/tags/132/azure-translator) and [Stack Overflow](htt
 ## Next steps
 
 >[!div class="nextstepaction"]
-> [**Document Translation SDK quickstart**](quickstarts/document-translation-sdk.md) [**Document Translation v1.1 REST API reference**](reference/rest-api-guide.md)
+> [**Document Translation SDK quickstart**](quickstarts/asynchronous-sdk.md) [**Document Translation v1.1 REST API reference**](reference/rest-api-guide.md)

articles/ai-services/translator/document-translation/how-to-guides/create-sas-tokens.md

@@ -6,7 +6,7 @@ ms.topic: how-to
 manager: nitinme
 ms.author: lajanuar
 author: laujan
-ms.date: 07/18/2023
+ms.date: 02/12/2024
 ---
 
 # Create SAS tokens for your storage containers
@@ -25,11 +25,11 @@ In this article, you learn how to create user delegation, shared access signatur
 
 At a high level, here's how SAS tokens work:
 
-* Your application submits the SAS token to Azure Storage as part of a REST API request.
+* An application submits the SAS token to Azure Storage as part of a REST API request.
 
-* If the storage service verifies that the SAS is valid, the request is authorized.
+* The storage service verifies that the SAS is valid. If so, the request is authorized.
 
-* If the SAS token is deemed invalid, the request is declined, and the error code 403 (Forbidden) is returned.
+* The request is declined If the SAS token is deemed invalid. If so, error code 403 (Forbidden) is returned.
 
 Azure Blob Storage offers three resource types:
 
@@ -64,24 +64,24 @@ Go to the [Azure portal](https://portal.azure.com/#home) and navigate to your co
 
 | Create SAS token for a container| Create SAS token for a specific file|
 |:-----:|:-----:|
-**Your storage account** → **containers** → **your container** |**Your storage account** → **containers** → **your container**→ **your file** |
+|**Your storage account** → **containers** → **your container** |**Your storage account** → **containers** → **your container**→ **your file** |
 
 1. Right-click the container or file and select **Generate SAS** from the drop-down menu.
 
 1. Select **Signing method** → **User delegation key**.
 
 1. Define **Permissions** by checking and/or clearing the appropriate check box:
 
-    * Your **source** container or file must have designated  **read** and **list** access.
+    * Your **source** container or file must designate  **read** and **list** access.
 
-    * Your **target** container or file must have designated  **write** and **list** access.
+    * Your **target** container or file must designate  **write** and **list** access.
 
 1. Specify the signed key **Start** and **Expiry** times.
 
     * When you create a shared access signature (SAS), the default duration is 48 hours. After 48 hours, you'll need to create a new token.
     * Consider setting a longer duration period for the time you're using your storage account for Translator Service operations.
     * The value of the expiry time is determined by whether you're using an **Account key** or **User delegation key** **Signing method**:
-       * **Account key**: There's no imposed maximum time limit; however, best practices recommended that you configure an expiration policy to limit the interval and minimize compromise. [Configure an expiration policy for shared access signatures](/azure/storage/common/sas-expiration-policy).
+       * **Account key**: While a maximum time limit isn't imposed, best practice recommends that you configure an expiration policy to limit the interval and minimize compromise. [Configure an expiration policy for shared access signatures](/azure/storage/common/sas-expiration-policy).
        * **User delegation key**: The value for the expiry time is a maximum of seven days from the creation of the SAS token. The SAS is invalid after the user delegation key expires, so a SAS with an expiry time of greater than seven days will still only be valid for seven days. For more information,*see* [Use Microsoft Entra credentials to secure a SAS](/azure/storage/blobs/storage-blob-user-delegation-sas-create-cli#use-azure-ad-credentials-to-secure-a-sas).
 
 1. The **Allowed IP addresses** field is optional and specifies an IP address or a range of IP addresses from which to accept requests. If the request IP address doesn't match the IP address or address range specified on the SAS token, authorization fails. The IP address or a range of IP addresses must be public IPs, not private. For more information,*see*, [**Specify an IP address or IP range**](/rest/api/storageservices/create-account-sas#specify-an-ip-address-or-ip-range).
@@ -133,8 +133,8 @@ Azure Storage Explorer is a free standalone app that enables you to easily manag
     * Specify the signed key **Start** and **Expiry** date and time. A short lifespan is recommended because, once generated, a SAS can't be revoked.
     * Select the **Time zone** for the Start and Expiry date and time (default is Local).
     * Define your container **Permissions** by checking and/or clearing the appropriate check box.
-        * Your **source** container or file must have designated  **read** and **list** access.
-        * Your **target** container or file must have designated  **write** and **list** access.
+        * Your **source** container or file must designate **read** and **list** access.
+        * Your **target** container or file must designate  **write** and **list** access.
     * Select **key1** or **key2**.
     * Review and select **Create**.
 
@@ -179,10 +179,10 @@ Here's a sample REST API request:
 }
 ```
 
-That's it! You've learned how to create SAS tokens to authorize how clients access your data.
+That's it! You just learned how to create SAS tokens to authorize how clients access your data.
 
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Get Started with Document Translation](../quickstarts/document-translation-rest-api.md)
+> [Get Started with Document Translation](../quickstarts/asynchronous-rest-api.md)
 >

articles/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities.md

@@ -1,13 +1,13 @@
 ---
 title: Create and use managed identities for Document Translation
 titleSuffix: Azure AI services
-description: Understand how to create and use managed identities in the Azure portal
+description: Understand how to create and use managed identities in the Azure portal.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: build-2023
 ms.topic: how-to
-ms.date: 07/18/2023
+ms.date: 02/12/2024
 ms.author: lajanuar
 ---
 
@@ -64,11 +64,11 @@ To get started, you need:
         > [!NOTE]
         > It may take up to 5 min for the network changes to propagate.
 
-    Although network access is now permitted, your Translator resource is still unable to access the data in your Storage account. You need to [create a managed identity](#managed-identity-assignments) for and [assign a specific access role](#grant-storage-account-access-for-your-translator-resource) to your Translator resource. 
+    Although network access is now permitted, your Translator resource is still unable to access the data in your Storage account. You need to [create a managed identity](#managed-identity-assignments) for and [assign a specific access role](#grant-storage-account-access-for-your-translator-resource) to your Translator resource.
 
 ## Managed identity assignments
 
-There are two types of managed identities: **system-assigned** and **user-assigned**.  Currently, Document Translation supports **system-assigned managed identity**:
+There are two types of managed identities: **system-assigned** and **user-assigned**. Currently, Document Translation supports **system-assigned managed identity**:
 
 * A system-assigned managed identity is **enabled** directly on a service instance. It isn't enabled by default; you must go to your resource and update the identity setting.
 
@@ -129,7 +129,7 @@ You must grant the Translator resource access to your storage account before it
 
 ## HTTP requests
 
-* A batch Document Translation request is submitted to your Translator service endpoint via a POST request.
+* An asynchronous batch translation request is submitted to your Translator service endpoint via a POST request.
 
 * With managed identity and `Azure RBAC`, you no longer need to include SAS URLs.
 
@@ -246,12 +246,12 @@ For more information, _see_ [request parameters](#post-request-body).
 }
 ```
 
-Great! You've learned how to enable and use a system-assigned managed identity. With managed identity for Azure Resources and `Azure RBAC`, you granted Translator specific access rights to your storage resource without including SAS tokens with your HTTP requests.
+Great! You just learned how to enable and use a system-assigned managed identity. With managed identity for Azure Resources and `Azure RBAC`, you granted Translator specific access rights to your storage resource without including SAS tokens with your HTTP requests.
 
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Quickstart: Get started with Document Translation](../quickstarts/document-translation-rest-api.md)
+> [Quickstart: Get started with Document Translation](../quickstarts/asynchronous-rest-api.md)
 
 > [!div class="nextstepaction"]
 > [Tutorial: Access Azure Storage from a web app using managed identities](../../../../app-service/scenario-secure-app-access-storage.md?bc=%2fazure%2fcognitive-services%2ftranslator%2fbreadcrumb%2ftoc.json&toc=%2fazure%2fcognitive-services%2ftranslator%2ftoc.json)