Merge pull request #227062 from laujan/63571-add-inline-feedback-dt

add inline-feedback-buttons to DT

Author: prmerger-automator[bot]

articles/cognitive-services/Translator/document-translation/quickstarts/get-started-with-rest-api.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 12/17/2022
+ms.date: 02/10/2023
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp, golang, java, javascript, python
@@ -17,7 +17,7 @@ zone_pivot_groups: programming-languages-set-translator
 
 # Get started with Document Translation
 
-   Document Translation is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service that asynchronously translates whole documents in [supported languages](../../language-support.md) and various [file formats](../overview.md#supported-document-formats). In this quickstart, you'll learn to use Document Translation with a programming language of your choice to translate a source document into a target language while preserving structure and text formatting.
+   Document Translation is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service that asynchronously translates whole documents in [supported languages](../../language-support.md) and various [file formats](../overview.md#supported-document-formats). In this quickstart, learn to use Document Translation with a programming language of your choice to translate a source document into a target language while preserving structure and text formatting.
 
 ## Prerequisites
 
@@ -28,11 +28,11 @@ zone_pivot_groups: programming-languages-set-translator
 > * Document Translation is **only** supported in the S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan. *See* [Cognitive Services pricing—Translator](https://azure.microsoft.com/pricing/details/cognitive-services/translator/).
 >
 
-To get started, you'll need:
+To get started, you need:
 
 * An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/).  If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
 
-* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You'll create containers to store and organize your blob data within your storage account.
+* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to create containers to store and organize your blob data within your storage account.
 
 * A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
 
@@ -66,6 +66,9 @@ The custom domain endpoint is a URL formatted with your resource name, hostname,
 > * **All API requests to the Document Translation service require a custom domain endpoint**.
 > * Don't use the Text Translation endpoint found on your Azure portal resource *Keys and Endpoint* page nor the global translator endpoint—`api.cognitive.microsofttranslator.com`—to make HTTP requests to Document Translation.
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue with the prerequisites.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?Pillar=Language&Product=Document-translation&Page=quickstart&Section=Prerequisites)
+
 ### Retrieve your key and endpoint
 
 Requests to the Translator service require a read-only key and custom endpoint to authenticate access.
@@ -76,16 +79,19 @@ Requests to the Translator service require a read-only key and custom endpoint t
 
 1. Copy and paste your **`key`** and **`document translation endpoint`** in a convenient location, such as *Microsoft Notepad*. Only one key is necessary to make an API call.
 
-1. You'll paste it into the code sample to authenticate your request to the Document Translation service.
+1. You **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
 
     :::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue retrieving my key and endpoint.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?Pillar=Language&Product=Document-translation&Page=quickstart&Section=Retrieve-your-keys-and-endpoint)
+
 ## Create Azure blob storage containers
 
-You'll need to  [**create containers**](../../../../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container) in your [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM) for source and target files.
+You need to  [**create containers**](../../../../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container) in your [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM) for source and target files.
 
 * **Source container**. This container is where you upload your files for translation (required).
-* **Target container**. This container is where your translated files will be stored (required).
+* **Target container**. This container is where your translated files are stored (required).
 
 ### **Required authentication**
 
@@ -101,13 +107,16 @@ The `sourceUrl` , `targetUrl` , and optional `glossaryUrl`  must include a Share
 > * If you're translating a **single** file (blob) in an operation, **delegate SAS access at the blob level**.
 > * As an alternative to SAS tokens, you can use a [**system-assigned managed identity**](../how-to-guides/create-use-managed-identities.md) for authentication.
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue creating blob storage containers with authentication.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?Pillar=Language&Product=Document-translation&Page=quickstart&Section=Create-blob-storage-containers)
+
 ### Sample document
 
-For this project, you'll need a **source document** uploaded to your **source container**. You can download our [document translation sample document](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/Translator/document-translation-sample.docx) for this quickstart.
+For this project, you need a **source document** uploaded to your **source container**. You can download our [document translation sample document](https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/Translator/document-translation-sample.docx) for this quickstart.
 
 ## HTTP request
 
-A batch Document Translation request is submitted to your Translator service endpoint via a POST request. If successful, the POST method returns a `202 Accepted`  response code and the batch request is created by the service. The translated documents will be listed in your target container.
+A batch Document Translation request is submitted to your Translator service endpoint via a POST request. If successful, the POST method returns a `202 Accepted`  response code and the batch request is created by the service. The translated documents are listed in your target container.
 
 ### Headers
 
@@ -163,4 +172,4 @@ That's it, congratulations! In this quickstart, you used Document Translation to
 Learn more about Document Translation:
 
 > [!div class="nextstepaction"]
->[Document Translation REST API guide](../reference/rest-api-guide.md) [Language support](../../language-support.md)
+>[Document Translation REST API guide](../reference/rest-api-guide.md) </br></br>[Language support](../../language-support.md)

articles/cognitive-services/Translator/document-translation/quickstarts/includes/csharp.md

@@ -6,14 +6,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: include
-ms.date: 12/08/2022
+ms.date: 02/10/2023
 ms.author: lajanuar
 recommendations: false
 ---
+<!-- markdownlint-disable MD051 -->
 
 ## Set up your C#/.NET environment
 
-For this quickstart, we'll use the latest version of [Visual Studio](https://visualstudio.microsoft.com/vs/) IDE to build and run the application.
+For this quickstart, we use the latest version of [Visual Studio](https://visualstudio.microsoft.com/vs/) IDE to build and run the application.
 
 1. Start Visual Studio.
 
@@ -33,6 +34,9 @@ For this quickstart, we'll use the latest version of [Visual Studio](https://vis
 
     :::image type="content" source="../../media/visual-studio/additional-information.png" alt-text="Screenshot of Visual Studio 2022 additional information set-up window.":::
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue setting up my environment.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Set-up-the-environment)
+
 ## Install Newtonsoft.Json
 
 1. Right-click on your **document-translation-qs** project and select **Manage NuGet Packages...** .
@@ -47,6 +51,9 @@ For this quickstart, we'll use the latest version of [Visual Studio](https://vis
 
     :::image type="content" source="../../media/visual-studio/install-nuget-package.png" alt-text="Screenshot of install selected NuGet package window.":::
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue installing the NuGet package.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Install-package)
+
 ## Translate all documents in a storage container
 
   > [!NOTE]
@@ -71,7 +78,6 @@ For this quickstart, we'll use the latest version of [Visual Studio](https://vis
   > [!IMPORTANT]
   > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). For more information, *see* Cognitive Services [security](../../../../../cognitive-services/security-features.md).
 
-
 ```csharp
 
 using System.Text;
@@ -130,6 +136,9 @@ class Program
 
 * The successful POST method returns a `202 Accepted`  response code indicating that the batch request was created by the service.
 
-* The POST request also returns response headers including `Operation-Location` that provides a value used in subsequent GET requests. 
+* The POST request also returns response headers including `Operation-Location` that provides a value used in subsequent GET requests.
+
+* The translated documents are listed in your target container.
 
-* The translated documents will be listed in your target container.
+  > [!div class="nextstepaction"]
+  > [I successfully translated my document.](#next-steps) [I ran into an issue](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=CSHARP&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Translate-documents)

articles/cognitive-services/Translator/document-translation/quickstarts/includes/go.md

@@ -6,11 +6,13 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: include
-ms.date: 12/16/2022
+ms.date: 02/10/2023
 ms.author: lajanuar
 recommendations: false
 ---
 
+<!-- markdownlint-disable MD051 -->
+
 ## Set up your Go environment
 
 You can use any text editor to write Go applications. We recommend using the latest version of [Visual Studio Code and the Go extension](/azure/developer/go/configure-visual-studio-code).
@@ -29,6 +31,9 @@ You can use any text editor to write Go applications. We recommend using the lat
           go version
         ```
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue setting up my environment.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=GO&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Set-up-the-environment)
+
 ## Translate all documents in a storage container
 
 1. In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app called **document-translation-qs**, and navigate to it.
@@ -45,7 +50,7 @@ You can use any text editor to write Go applications. We recommend using the lat
 
   > [!IMPORTANT]
   > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). For more information, *see* Cognitive Services [security](../../../../../cognitive-services/security-features.md).
-  
+
 ```go
 
 package main
@@ -108,8 +113,11 @@ func main() {
      go run document-translation.go
     ```
 
-* The successful POST method returns a `202 Accepted` response code indicating that the batch request was created by the service. 
+* The successful POST method returns a `202 Accepted` response code indicating that the batch request was created by the service.
+
+* The POST request also returns response headers including `Operation-Location` that provides a value used in subsequent GET requests.
 
-* The POST request also returns response headers including `Operation-Location` that provides a value used in subsequent GET requests. 
+* The translated documents are listed in your target container.
 
-* The translated documents will be listed in your target container.
+  > [!div class="nextstepaction"]
+  > [I successfully translated my document.](#next-steps)  [I ran into an issue.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=GO&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Translate-documents)

articles/cognitive-services/Translator/document-translation/quickstarts/includes/java.md

@@ -6,15 +6,16 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: include
-ms.date: 12/17/2022
+ms.date: 02/10/2023
 ms.author: lajanuar
 recommendations: false
 ---
 
+<!-- markdownlint-disable MD051 -->
 
 ## Set up your Java environment
 
-For this quickstart, we'll use the Gradle build automation tool to create and run the application.
+For this quickstart, we use the Gradle build automation tool to create and run the application.
 
 * You should have the latest version of [Visual Studio Code](https://code.visualstudio.com/) or your preferred IDE. _See_ [Java in Visual Studio Code](https://code.visualstudio.com/docs/languages/java).
 
@@ -23,12 +24,15 @@ For this quickstart, we'll use the Gradle build automation tool to create and ru
   > * Visual Studio Code offers a **Coding Pack for Java** for Windows and macOS.The coding pack is a bundle of VS Code, the Java Development Kit (JDK), and a collection of suggested extensions by Microsoft. The Coding Pack can also be used to fix an existing development environment.
   > * If you are using VS Code and the Coding Pack For Java, install the [**Gradle for Java**](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-gradle) extension.
 
-* If you aren't using VS Code, make sure you have the following installed in your development environment:
+* If you aren't using Visual Studio Code, make sure you have the following installed in your development environment:
 
   * A [**Java Development Kit** (OpenJDK)](/java/openjdk/download#openjdk-17) version 8 or later.
 
   * [**Gradle**](https://docs.gradle.org/current/userguide/installation.html), version 6.8 or later.
 
+  > [!div class="nextstepaction"]
+  > [I ran into an issue setting up my environment.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Translate-documents)
+
 ## Create a new Gradle project
 
 1. In console window (such as cmd, PowerShell, or Bash), create a new directory for your app called **document-translation**, and navigate to it.
@@ -41,7 +45,7 @@ For this quickstart, we'll use the Gradle build automation tool to create and ru
     mkdir document-translation; cd document-translation
    ```
 
-1. Run the `gradle init` command from the document-translation directory. This command will create essential build files for Gradle, including _build.gradle.kts_, which is used at runtime to create and configure your application.
+1. Run the `gradle init` command from the document-translation directory. This command creates essential build files for Gradle, including _build.gradle.kts_, which is used at runtime to create and configure your application.
 
     ```console
     gradle init --type basic
@@ -73,6 +77,9 @@ For this quickstart, we'll use the Gradle build automation tool to create and ru
   }
   ```
 
+  > [!div class="nextstepaction"]
+  > [I ran into creating a Gradle project.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Create-gradle-project)
+
 ## Translate all documents in a storage container
 
 1. From the document-translation directory, run the following command:
@@ -81,7 +88,7 @@ For this quickstart, we'll use the Gradle build automation tool to create and ru
     mkdir -p src/main/java
     ```
 
-   You'll create the following directory structure:
+   The command creates the following directory structure:
 
     :::image type="content" source="../../media/java-directories.png" alt-text="Screenshot: Java directory structure.":::
 
@@ -172,4 +179,7 @@ public class DocumentTranslation {
 
 * The POST request also returns response headers including `Operation-Location` that provides a value used in subsequent GET requests.
 
-* The translated documents will be listed in your target container.
+* The translated documents are listed in your target container.
+
+  > [!div class="nextstepaction"]
+  > [I successfully translated my document.](#next-steps)  [I ran into an issue.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Language&Product=Document-translation&Page=quickstart&Section=Translate-documents)