Merge pull request #2540 from laujan/361124-translator-january-freshness

361124 translator january freshness

Author: JillGrant615

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

@@ -1,13 +1,12 @@
 ---
-title: "Use Translator V3 connector to build a Document Translation flow"
+title: "Use Microsoft Azure V3 connector to build a Document Translation flow"
 titleSuffix: Azure AI services
-description: Use Microsoft Translator V3 connector and Power Automate to create a Document Translation flow.
+description: Use Microsoft Azure Translator V3 connector and Power Automate to create a Document Translation flow.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
-ms.custom: build-2023, build-2023-dataai
 ms.topic: tutorial
-ms.date: 07/09/2024
+ms.date: 01/27/2025
 ms.author: lajanuar
 ---
 
@@ -17,13 +16,13 @@ ms.author: lajanuar
 <!-- markdownlint-disable MD036 -->
 <!-- markdownlint-disable MD001 -->
 
-# Create a Document Translation flow (preview)
+# Create an Azure AI Translator Document Translation flow (preview)
 
 > [!IMPORTANT]
 >
-> The Translator connector is currently available in public preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
+> The Microsoft Azure Translator connector is currently available in public preview. Features, approaches, and processes may change, before General Availability (GA) release, based on user feedback.
 
-This tutorial guides you through configuring a Microsoft Translator V3 connector cloud flow that supports document translation. The Translator V3 connector creates a connection between your Translator Service instance and Microsoft Power Automate enabling you to use one or more prebuilt operations as steps in your apps and workflows.
+This tutorial guides you through configuring a Microsoft Azure Translator V3 connector cloud flow that supports document translation. The Translator V3 connector creates a connection between your Translator Service instance and Microsoft Power Automate enabling you to use one or more prebuilt operations as steps in your apps and workflows.
 
 Document Translation is a cloud-based REST API feature of the Azure AI Translator service. The Document Translation API enables multiple and complex document translations while preserving original document structure and data format.
 
@@ -75,7 +74,7 @@ Here's what you need to get started: [**Translator resource**](#translator-resou
    1. Deselect all check boxes.
    1. Make sure **Microsoft network routing** is selected.
    1. Under the **Resource instances** section, select **Microsoft.CognitiveServices/accounts** as the resource type and select your Translator resource as the instance name.
-   1. Make certain that the **Allow Azure services on the trusted services list to access this storage account** box is checked. For more information about managing exceptions, *see* [Configure Azure Storage firewalls and virtual networks](/azure/storage/common/storage-network-security).
+   1. Make certain that the **`Allow Azure services on the trusted services list to access this storage account`** box is checked. For more information about managing exceptions, *see* [Configure Azure Storage firewalls and virtual networks](/azure/storage/common/storage-network-security).
 
       :::image type="content" source="../media/managed-identities/allow-trusted-services-checkbox-portal-view.png" alt-text="Screenshot: allow trusted services checkbox, portal view.":::
 
@@ -114,7 +113,7 @@ Next, assign a **`Storage Blob Data Contributor`** role to the managed identity
 
     :::image type="content" source="../media/managed-identities/azure-role-assignments-page-portal.png" alt-text="Screenshot: Azure role assignments page in the Azure portal.":::
 
-1. Finally, assign a **Storage Blob Data Contributor** role to your Translator service resource. The **Storage Blob Data Contributor** role gives Translator (represented by the system-assigned managed identity) read, write, and delete access to the blob container and data. In the **Add role assignment** pop-up window, complete the fields as follows and select **Save**:
+1. Finally, assign a **Storage Blob Data Contributor** role to your Translator service resource. The **Storage Blob Data Contributor** role gives Translator (represented by the system-assigned managed identity) read, write, and delete access to the blob container and data. In the **`Add role assignment`** pop-up window, complete the fields as follows and select **Save**:
 
     | Field | Value|
     |------|--------|
@@ -168,7 +167,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
 > * Translate your document(s) choosing source and target languages.
 > * Get the status of the translation operation.
 
-1. In the **Choose an operation** pop-up window, enter Translator V3 in the **Search connectors and actions** search bar and select the **Microsoft Translator V3** icon.
+1. In the **Choose an operation** pop-up window, enter Translator V3 in the **Search connectors and actions** search bar and select the **Microsoft Azure Translator V3** icon.
 
    :::image type="content" source="../media/connectors/choose-operation.png" alt-text="Screenshot showing the selection of Translator V3 as the next flow step.":::
 
@@ -184,7 +183,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
       :::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.
+      > After you set up your connection, you won't be required to reenter your credentials for subsequent flows.
 
 1. The **Start document translation** action window now appears. Complete the fields as follows:
 
@@ -202,7 +201,7 @@ Here are the steps to translate a file in Azure Blob Storage using the Translato
          |Select the checkbox next to the source container|Select the checkbox next to the target container.|
          | From the main window area, select a file or document for translation.| Select the ellipses located at the right, then choose **Properties**.|
          | The source URL is located at the top of the Properties list. Select the **Copy to Clipboard** icon.|The target URL is located at the top of the Properties list. Select the **Copy to Clipboard** icon.|
-         | Navigate to your Power automate flow and paste the source URL in the **Location of the source documents** field.|Navigate to your Power automate flow and paste the target URL in the **Location of the translated documents** field.|
+         | Navigate to your Power Automate flow and paste the source URL in the **Location of the source documents** field.|Navigate to your Power Automate flow and paste the target URL in the **Location of the translated documents** field.|
    * Choose a **Target Language** from the dropdown menu and select **Save**.
 
       :::image type="content" source="../media/connectors/start-document-translation-window.png" alt-text="Screenshot of the Start document translation dialog window.":::
@@ -213,7 +212,7 @@ Now that you submitted your documents for translation, let's check the status of
 
 1. Select **New step**.
 
-1. Enter Translator V3 in the search box and choose **Microsoft Translator V3**.
+1. Enter Translator V3 in the search box and choose **Microsoft Azure Translator V3**.
 
 1. Select **Get documents status** (not the singular Get *document* status action).
 
@@ -290,7 +289,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
 
 1. Select **New step** and enter **Azure Blob Storage** in the search box.
 
-1. Select the **Create blob (V2)** action.
+1. Select the **`Create blob (V2)`** action.
 
 1. If you're using the Azure storage step for the first time, you need to enter your storage resource authentication:
 
@@ -313,7 +312,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
 
 1. Select **New step**.
 
-1. Enter Translator V3 in the search box and choose **Microsoft Translator V3**.
+1. Enter Translator V3 in the search box and choose **Microsoft Azure Translator V3**.
 
 1. Select the **Start document translation** action.
 
@@ -327,7 +326,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
       :::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.
+      > After setting up your connection, you won't be required to reenter your credentials for subsequent Translator flows.
 
 1. The **Start document translation** action window now appears. Complete the fields as follows:
 
@@ -343,7 +342,7 @@ Here are the steps to upload a file from your SharePoint site to Azure Blob Stor
    * Select the checkbox next to the target container.
    * Select the ellipses located at the right, then choose **Properties**.
    * The target URL is located at the top of the Properties list. Select the **Copy to Clipboard** icon.
-   * Navigate back to your Power automate flow and paste the target URL in the **Location of the translated documents** field.
+   * Navigate back to your Power Automate flow and paste the target URL in the **Location of the translated documents** field.
 
 1. Choose a **Target Language** from the dropdown menu and select **Save**.
 
@@ -359,7 +358,7 @@ Before retrieving the documents status, let's schedule a 30-second delay to ensu
 
    :::image type="content" source="../media/connectors/delay-step.png" alt-text="Screenshot showing the delay step.":::
 
-1. Select **New step**. Enter Translator V3 in the search box and choose **Microsoft Translator V3**.
+1. Select **New step**. Enter Translator V3 in the search box and choose **Microsoft Azure Translator V3**.
 
 1. Select **Get documents status** (not the singular Get *document* status).
 
@@ -402,7 +401,7 @@ In this step, you retrieve the translated document from Azure Blob Storage and u
 
    :::image type="content" source="../media/connectors/do-until-progress.png" alt-text="Screenshot showing the Do until control action.":::
 
-1. Select **Add an action**, enter **Azure Blob Storage** in the search box, and select the **Get blob content using path (V2)** action.
+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:
 
@@ -412,12 +411,12 @@ 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. 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.":::
 
-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 then enter the following logic in the formula field:
 
    ```powerappsfl
 
@@ -452,16 +451,16 @@ Let's check your document translation flow and results.
 
    :::image type="content" source="../media/connectors/test-flow.png" alt-text="Screenshot showing the test icon/button.":::
 
-1. Select **Test Flow** → **Manually** → **Test** from the right-side window.
-1. In the **Run flow** window, select the **Continue** then the **Run flow** buttons.
-1. Finally, select  the **Done** button.
+1. Select **`Test Flow`** → **Manually** → **Test** from the right-side window.
+1. In the **`Run flow`** window, select the **Continue** then the **`Run flow`** buttons.
+1. Finally, select  the **`Done`** button.
 1. You should receive a "Your flow ran successfully" message and green check marks align with each successful step.
 
    :::image type="content" source="../media/connectors/successful-sharepoint-flow.png" alt-text="Screenshot showing a successful flow using SharePoint and Azure Blob Storage.":::
 
 ---
 
-That's it! You 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 Azure 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/10/2024
+ms.date: 01/28/2025
 ms.author: lajanuar
 ---
 
@@ -21,7 +21,7 @@ ms.author: lajanuar
 
 > [!IMPORTANT]
 >
-> * The Translator connector is currently available in public preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
+> * The Translator connector is currently available in public preview. Features, approaches, and processes can change, before General Availability (GA) release, based on user feedback.
 
 This article guides you through configuring a Microsoft Translator V3 connector cloud flow that supports text translation and transliteration. The Translator V3 connector creates a connection between your Translator Service instance and Microsoft Power Automate enabling you to use one or more prebuilt operations as steps in your apps and workflows.
 
@@ -79,7 +79,7 @@ Let's select an action. Choose to translate or transliterate text.
       :::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.
+      > After setting up your connection, you won't be required to reenter your credentials for subsequent Translator flows.
 
 1. The **Translate text** action window appears next.
 1. Select a **Source Language** from the dropdown menu or keep the default **Auto-detect** option.

articles/ai-services/translator/containers/configuration.md

@@ -1,22 +1,22 @@
 ---
-title: Configure containers - Translator
+title: Configure containers - Azure AI Translator
 titleSuffix: Azure AI services
-description: The Translator container runtime environment is configured using the `docker run` command arguments. There are both required and optional settings.
+description: The Azure AI Translator container runtime environment is configured using the `docker run` command arguments. There are both required and optional settings.
 #services: cognitive-services
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: how-to
-ms.date: 04/08/2024
+ms.date: 01/28/2025
 ms.author: lajanuar
 recommendations: false
 ---
 
-# Configure Translator Docker containers
+# Configure Azure AI Translator Docker containers
 
 Azure AI services provide each container with a common configuration framework. You can easily configure your Translator containers to build Translator application architecture optimized for robust cloud capabilities and edge locality.
 
-The **Translator** container runtime environment is configured using the `docker run` command arguments. This container has both required and optional settings. The required container-specific settings are the billing settings.
+The **Azure AI Translator** container runtime environment is configured using the `docker run` command arguments. This container has both required and optional settings. The required container-specific settings are the billing settings.
 
 ## Configuration settings
 
@@ -34,7 +34,7 @@ The container has the following configuration settings:
 |Yes|[Mounts](#mount-settings)|Reads and writes data from the host computer to the container and from the container back to the host computer.|
 
  > [!IMPORTANT]
-> The [**ApiKey**](#apikey-configuration-setting), [**Billing**](#billing-configuration-setting), and [**EULA**](#eula-setting) settings are used together, and you must provide valid values for all three of them; otherwise your container won't start. For more information about using these configuration settings to instantiate a container.
+ > The [**ApiKey**](#apikey-configuration-setting), [**Billing**](#billing-configuration-setting), and [**EULA**](#eula-setting) settings are used together, and you must provide valid values for all three of them; otherwise your container can't start. For more information about using these configuration settings to instantiate a container, *see* [Install and run Azure AI Translator container](install-run.md).
 
 ## ApiKey configuration setting