july freshness

Author: laujan

articles/ai-services/translator/connector/document-translation-flow.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: build-2023, build-2023-dataai
 ms.topic: tutorial
-ms.date: 07/18/2023
+ms.date: 07/09/2024
 ms.author: lajanuar
 ---
 
@@ -133,7 +133,7 @@ Next, assign a **`Storage Blob Data Contributor`** role to the managed identity
 
 ### Configure a Document Translation flow
 
-Now that you've completed the prerequisites and initial setup, let's get started using the Translator V3 connector to create your document translation flow:
+Now that you completed the prerequisites and initial setup, let's get started using the Translator V3 connector to create your document translation flow:
 
 1. Sign in to [Power Automate](https://powerautomate.microsoft.com/).
 
@@ -181,7 +181,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
 
    * **Translator resource name**. Enter the name of your Translator resource found at the top of your resource page in the Azure portal. Select **Create**.
 
-      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add connection window.":::
+      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the  how-to-add connection window.":::
 
       > [!NOTE]
       > After you've set up your connection, you won't be required to reenter your credentials for subsequent flows.
@@ -190,7 +190,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
 
    * For **Storage type of the input documents**. Select **File** or **Folder**.
    * Select a **Source Language** from the dropdown menu or keep the default **Auto-detect** option.
-   * **Location of the source documents**. Enter the URL for your document(s) in your Azure storage source document container.
+   * **Location of the source documents**. Enter the URL for your documents in your Azure storage source document container.
    * **Location of the translated documents**. Enter the URL for your Azure storage target document container.
 
       To find your source and target URLs:
@@ -209,7 +209,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
 
 ## Get documents status
 
-Now that you've submitted your document(s) for translation, let's check the status of the operation.
+Now that you submitted your documents for translation, let's check the status of the operation.
 
 1. Select **New step**.
 
@@ -278,13 +278,13 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
 
 ##### Get file content
 
- 1. In the Choose an operation pop-up window, enter **SharePoint**, then select the **Get file content** content. Power Automate automatically signs you into your SharePoint account(s).
+ 1. In the Choose an operation pop-up window, enter **SharePoint**, then select the **Get file content** content. Power Automate automatically signs you into your SharePoint accounts.
 
       :::image type="content" source="../media/connectors/get-file-content.png" alt-text="Screenshot of the SharePoint Get file content action.":::
 
 1. On the **Get file content** step window, complete the following fields:
     * **Site Address**. Select the SharePoint site URL where your file is located from the dropdown list.
-    * **File Identifier**. Select the folder icon and choose the document(s) for translation.
+    * **File Identifier**. Select the folder icon and choose the documents for translation.
 
 ##### Create a storage blob
 
@@ -300,7 +300,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
 
 1. Choose the Microsoft Entra account associated with your Azure Blob Storage and Translator resource accounts.
 
-1. After you have completed the **Azure Blob Storage** authentication, the **Create blob** step appears. Complete the fields as follows:
+1. After you completed the **Azure Blob Storage** authentication, the **Create blob** step appears. Complete the fields as follows:
 
    * **Storage account name or blob endpoint**. Select **Enter custom value** and enter your storage account name.
    * **Folder path**. Select the folder icon and select your source document container.
@@ -324,7 +324,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
    * **Translator resource name**. Enter the name of your Translator resource found at the top of your resource page in the Azure portal.
    * Select **Create**.
 
-      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add connection window.":::
+      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the how-to-add connection window.":::
 
       > [!NOTE]
       > After you've setup your connection, you won't be required to reenter your credentials for subsequent Translator flows.
@@ -351,7 +351,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
 
 ##### Get documents status
 
-Prior to retrieving the documents status, let's schedule a 30-second delay to ensure that the file has been processed for translation:
+Before retrieving the documents status, let's schedule a 30-second delay to ensure that the file is processed for translation:
 
 1. Select **New step**. Enter **Schedule** in the search box and choose **Delay**.
    * For **Count**. Enter **30**.
@@ -404,7 +404,7 @@ In this step, you retrieve the translated document from Azure Blob Storage and u
 
 1. Select **Add an action**, enter **Azure Blob Storage** in the search box, and select the **Get blob content using path (V2)** action.
 1. In the **Storage account name or blob endpoint** field, select **Enter custom value** and enter your storage account name.
-1. Select the **Blob path** field to show the **Dynamic content** window, select **Expression** and enter the following logic in the formula field:
+1. Select the **Blob path** field to show the **Dynamic content** window, select **Expression**, and enter the following logic in the formula field:
 
    ```powerappsfl
 
@@ -415,7 +415,7 @@ In this step, you retrieve the translated document from Azure Blob Storage and u
 1. Select **Add an action**, enter **Azure Blob Storage** in the search box, and select the **Get Blob Metadata using path (V2)** action.
 1. In the **Storage account name or blob endpoint** field, select **Enter custom value** and enter your storage account name.
 
-   :::image type="content" source="../media/connectors/enter-custom-value.png" alt-text="Screenshot showing 'enter custom value' from the Create blob (V2) window.":::
+   :::image type="content" source="../media/connectors/enter-custom-value.png" alt-text="Screenshot showing 'enter custom value' from the create-blob-(V2) window.":::
 
 1. Select the **Blob path** field to show the **Dynamic content** window, select **Expression** and enter the following logic in the formula field:
 
@@ -461,7 +461,7 @@ Let's check your document translation flow and results.
 
 ---
 
-That's it! You've learned to automate document translation processes using the Microsoft Translator V3 connector and Power Automate.
+That's it! You learned to automate document translation processes using the Microsoft Translator V3 connector and Power Automate.
 
 ## Next steps
 

articles/ai-services/translator/connector/text-translator-flow.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: build-2023
 ms.topic: how-to
-ms.date: 07/18/2023
+ms.date: 07/10/2024
 ms.author: lajanuar
 ---
 
@@ -39,7 +39,7 @@ To get started, you need  an active Azure subscription. If you don't have an Azu
 
 ## Configure the Translator V3 connector
 
-Now that you've completed the prerequisites, let's get started.
+Now that you completed the prerequisites, let's get started.
 
 1. Sign in to [Power Automate](https://powerautomate.microsoft.com/).
 
@@ -76,7 +76,7 @@ Let's select an action. Choose to translate or transliterate text.
    * **Subscription Key**. Enter one of your keys that you copied from the Azure portal.
    * **Translator resource name**. Enter the name of your Translator resource found at the top of your resource page in the Azure portal. Select **Create**.
 
-      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add connection window.":::
+      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add-connection window.":::
 
       > [!NOTE]
       > After you've setup your connection, you won't be required to reenter your credentials for subsequent Translator flows.
@@ -87,7 +87,7 @@ Let's select an action. Choose to translate or transliterate text.
 1. Enter the **Body Text**.
 1. Select **Save**.
 
-   :::image type="content" source="../media/connectors/translate-text-step.png" alt-text="Screenshot showing the translate text step.":::
+   :::image type="content" source="../media/connectors/translate-text-step.png" alt-text="Screenshot showing the translate-text step.":::
 
 #### [Transliterate text](#tab/transliterate)
 
@@ -100,15 +100,15 @@ Let's select an action. Choose to translate or transliterate text.
    * **Subscription Key**. Enter one of your keys that you copied from the Azure portal.
    * **Translator resource name**. Enter the name of your Translator resource found at the top of your resource page in the Azure portal. Select **Create**.
 
-      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add connection window.":::
+      :::image type="content" source="../media/connectors/add-connection.png" alt-text="Screenshot showing the add-connection window.":::
 
 1. Next, the **Transliterate** action window appears.
 1. **Language**. Select the language of the text that is to be converted.
 1. **Source script**. Select the name of the input text script.
 1. **Target script**. Select the name of transliterated text script.
 1. Select **Save**.
 
-   :::image type="content" source="../media/connectors/transliterate-text-step.png" alt-text="Screenshot showing the transliterate text step.":::
+   :::image type="content" source="../media/connectors/transliterate-text-step.png" alt-text="Screenshot showing the transliterate-text step.":::
 
 ---
 

articles/ai-services/translator/containers/deploy-user-managed-glossary.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: how-to
-ms.date: 08/15/2023
+ms.date: 07/10/2024
 ms.author: lajanuar
 recommendations: false
 ---

articles/ai-services/translator/custom-translator/concepts/bleu-score.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: conceptual
-ms.date: 07/18/2023
+ms.date: 07/09/2024
 ms.author: lajanuar
 ms.custom: cogserv-non-critical-translator
 #Customer intent: As a Custom Translator user, I want to understand how BLEU score works so that I understand system test outcome better.
@@ -34,7 +34,7 @@ A more extensive discussion of BLEU scores is [here](https://youtu.be/-UqDljMymM
 
 BLEU results depend strongly on the breadth of your domain; consistency of
 test, training and tuning data; and how much data you have
-available for training. If your models have been trained on a narrow domain, and
+available for training. If your models are trained within a narrow domain, and
 your training data is consistent with your test data, you can expect a high
 BLEU score.
 

articles/ai-services/translator/custom-translator/concepts/customization.md

@@ -7,7 +7,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: conceptual
-ms.date: 07/18/2023
+ms.date: 07/09/2024
 ms.author: lajanuar
 ---
 
@@ -19,17 +19,17 @@ The feature can also be used to customize speech translation when used with [Azu
 
 ## Custom Translator
 
-With Custom Translator, you can build neural translation systems that understand the terminology used in your own business and industry. The customized translation system will then integrate into existing applications, workflows, and websites.
+With Custom Translator, you can build neural translation systems that understand the terminology used in your own business and industry. The customized translation system integrates into existing applications, workflows, and websites.
 
 ### How does it work?
 
-Use your previously translated documents (leaflets, webpages, documentation, etc.) to build a translation system that reflects your domain-specific terminology and style, better than a standard translation system. Users can upload TMX, XLIFF, TXT, DOCX, and XLSX documents.  
+Use your previously translated documents (leaflets, webpages, documentation, etc.) to build a translation system that reflects your domain-specific terminology and style, better than a standard translation system. Users can upload `TMX`,`XLIFF`,`TXT`, `DOCX`, and `XLSX` documents.  
 
-The system also accepts data that is parallel at the document level but isn't yet aligned at the sentence level. If users have access to versions of the same content in multiple languages but in separate documents, Custom Translator will be able to automatically match sentences across documents.  The system can also use monolingual data in either or both languages to complement the parallel training data to improve the translations.
+The system also accepts data that is parallel at the document level but isn't yet aligned at the sentence level. If users have access to versions of the same content in multiple languages but in separate documents, Custom Translator os able to automatically match sentences across documents. The system can also use monolingual data in either or both languages to complement the parallel training data to improve the translations.
 
 The customized system is then available through a regular call to Translator using the category parameter.
 
-Given the appropriate type and amount of training data it isn't uncommon to expect gains between 5 and 10, or even more BLEU points on translation quality by using Custom Translator.
+Given the appropriate type and amount of training data it isn't uncommon to expect gains between 5 and 10, or even more `BLEU` points on translation quality by using Custom Translator.
 
 More details about the various levels of customization based on available data can be found in the [Custom Translator User Guide](../overview.md).
 

articles/ai-services/translator/custom-translator/concepts/dictionaries.md

@@ -5,7 +5,7 @@ description: How to create an aligned document that specifies a list of phrases
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
-ms.date: 07/18/2023
+ms.date: 07/09/2024
 ms.author: lajanuar
 ms.topic: conceptual
 ms.custom: cogserv-non-critical-translator
@@ -32,11 +32,11 @@ The [neural phrase dictionary](../../neural-dictionary.md) extends our [dynamic
 
 ## Sentence dictionary
 
-A sentence dictionary is case-insensitive. The sentence dictionary allows you to specify an exact target translation for a source sentence. For a sentence dictionary match to occur, the entire submitted sentence must match the source dictionary entry. A source dictionary entry that ends with punctuation is ignored during the match. If only a portion of the sentence matches, the entry isn't matched.  When a match is detected, the target entry of the sentence dictionary is returned.
+A sentence dictionary is case-insensitive. The sentence dictionary allows you to specify an exact target translation for a source sentence. For a sentence dictionary match to occur, the entire submitted sentence must match the source dictionary entry. A source dictionary entry that ends with punctuation is ignored during the match. If only a portion of the sentence matches, the entry isn't matched. When a match is detected, the target entry of the sentence dictionary is returned.
 
 ## Dictionary-only trainings
 
-You can train a model using only dictionary data. To do so, select only the dictionary document (or multiple dictionary documents) that you wish to include and select **Create model**. Since this training is dictionary-only, there's no minimum number of training sentences required. Your model typically completes training faster than a standard training.  The resulting models use the Microsoft baseline models for translation with the addition of the dictionaries you add.  You don't get a test report.
+You can train a model using only dictionary data. To do so, select only the dictionary document (or multiple dictionary documents) that you wish to include and select **Create model**. Since this training is dictionary-only, there's no minimum number of training sentences required. Your model typically completes training faster than a standard training. The resulting models use the Microsoft baseline models for translation with the addition of the dictionaries you add. You don't get a test report.
 
 >[!Note]
 >Custom Translator doesn't sentence align dictionary files, so it is important that there are an equal number of source and target phrases/sentences in your dictionary documents and that they are precisely aligned.
@@ -47,14 +47,14 @@ You can train a model using only dictionary data. To do so, select only the dict
 
 - The phrase dictionary should be used sparingly. When a phrase within a sentence is replaced, the context of that sentence is lost or limited for translating the rest of the sentence. The result is that, while the phrase or word within the sentence is translated according to the provided dictionary, the overall translation quality of the sentence often suffers.
 
-- The phrase dictionary works well for compound nouns like product names ("_Microsoft SQL Server_"), proper names ("_City of Hamburg_"), or product features ("_pivot table_"). It doesn't work as well for verbs or adjectives because those words are typically highly contextual within the source or target language. The best practice is to avoid phrase dictionary entries for anything but compound nouns.
+- The phrase dictionary works well for compound nouns like product names ("_Microsoft SQL Server_"), proper names ("_City of Hamburg_"), or product features ("_pivot table_"). It doesn't work as well for verbs or adjectives because, typically, those words are highly contextual within the source or target language. The best practice is to avoid phrase dictionary entries for anything but compound nouns.
 
 - If you're using a phrase dictionary, capitalization and punctuation are important. Dictionary entries are case- and punctuation-sensitive. Custom Translator only matches words and phrases in the input sentence that use exactly the same capitalization and punctuation marks as specified in the source dictionary file. Also, translations reflect the capitalization and punctuation provided in the target dictionary file.
 
   **Example**
 
   - If you're training an English-to-Spanish system that uses a phrase dictionary and you specify _SQL server_ in the source file and _Microsoft SQL Server_ in the target file. When you request the translation of a sentence that contains the phrase _SQL server_, Custom Translator matches the dictionary entry and the translation that contains _Microsoft SQL Server_.
-  - When you request translation of a sentence that includes the same phrase but **doesn't** match what is in your source file, such as _sql server_, _sql Server_ or _SQL Server_, it **won't** return a match from your dictionary.
+  - When you request translation of a sentence that includes the same phrase but **doesn't** match what is in your source file, such as _sql server_, _sql Server_, or _SQL Server_, it **won't** return a match from your dictionary.
   - The translation follows the rules of the target language as specified in your phrase dictionary.
 
 - For more information about neural phrase dictionary, _see_ [neural dictionary guidance and recommendations](../../neural-dictionary.md#guidance-and-recommendations).
@@ -63,7 +63,7 @@ You can train a model using only dictionary data. To do so, select only the dict
 
   **Example**
 
-  - If your source dictionary contains "_This sentence ends with punctuation!_", then any translation requests containing "_This sentence ends with punctuation_" matches.
+  - If your source dictionary contains "_This sentence ends with punctuation!_", then any translation requests that contain "_This sentence ends with punctuation_" matches.
 
 - Your dictionary should contain unique source lines. If a source line (a word, phrase, or sentence) appears more than once in a dictionary file, the system always uses the **last entry** provided and return the target when a match is found.