Merge pull request #110600 from swmachan/master

Updated alignment and dynamic dictionary sections

Author: PRMerger16

articles/azure-government/documentation-government-cognitiveservices.md

@@ -624,6 +624,10 @@ For more information, please see [public documentation](../cognitive-services/Fa
 ### Variations
 * The URI for accessing the Text Translation API in Azure Government is: 
   - `https://api.cognitive.microsofttranslator.us`
+* [Virtual Network support](../cognitive-services/cognitive-services-virtual-networks.md) for Translator service is limited to only `US Gov Virginia` region. 
+  The URI for accessing the API is:
+  - `https://<your-custom-domain>.cognitiveservices.azure.us/translator/text/v3.0`
+  - You can find your custom domain endpoint in the overview blade on the Azure portal once the resource is created. 
 * There are 2 regions `USGovVirginia` and `USGovArizona`
 ### Text Translation Method
 The below example uses [Text Translation - Translate method](../cognitive-services/translator/reference/v3-0-translate.md) to translate a string of text from a language into another specified language. There are multiple [language codes](https://api.cognitive.microsofttranslator.com/languages?api-version=3.0&scope=translation) that can be used with the Text Translation API. 
@@ -634,10 +638,11 @@ The sample is written in C#.
 
 1. Create a new Console solution in Visual Studio.
 2. Replace Program.cs with the corresponding code below.
-3. Replace the `subscriptionKey` value with the key value that you retrieved above.
-4. Replace the `region` value with the region value where you created your translator resource.
-5. Replace the `text` value with text that you want to translate.
-6. Run the program.
+3. Replace the `endpoint` value with the URI as explained in the `Variations` section. 
+4. Replace the `subscriptionKey` value with the key value that you retrieved above.
+5. Replace the `region` value with the region value where you created your translator resource.
+6. Replace the `text` value with text that you want to translate.
+7. Run the program.
 
 You can also test out different languages and texts by replacing the "text", "from", and "to" variables in Program.cs. 
 
@@ -659,7 +664,7 @@ namespace TextTranslator
 {
     class Program
     {
-        static string host = "https://api.cognitive.microsofttranslator.us";
+        static string host = "PASTE ENDPOINT HERE";
         static string path = "/translate?api-version=3.0";
         // Translate to German.
         static string params_ = "&to=de";

articles/cognitive-services/Translator/reference/v3-0-reference.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: reference
-ms.date: 4/2/2020
+ms.date: 4/17/2020
 ms.author: swmachan
 ---
 
@@ -142,7 +142,7 @@ An authentication token is valid for 10 minutes. The token should be reused when
 
 ## Virtual Network support
 
-Translator service is now available with Virtual Network capabilities in limited regions (`WestUS2`, `EastUS`, `SouthCentralUS`, `WestUS`, `Central US EUAP`, `global`). To enable Virtual Network, please see [Configuring Azure Cognitive Services Virtual Networks](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-virtual-networks?tabs=portal). 
+Translator service is now available with Virtual Network capabilities in limited regions (`WestUS2`, `EastUS`, `SouthCentralUS`, `WestUS`, `CentralUSEUAP`, `global`). To enable Virtual Network, please see [Configuring Azure Cognitive Services Virtual Networks](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-virtual-networks?tabs=portal). 
 
 Once you turn on this capability, you must use the custom endpoint to call the Translator API. You cannot use the global translator endpoint ("api.cognitive.microsofttranslator.com") and you cannot authenticate with an access token.
 

articles/cognitive-services/Translator/reference/v3-0-translate.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: reference
-ms.date: 03/20/2020
+ms.date: 04/17/2020
 ms.author: swmachan
 ---
 
@@ -450,6 +450,14 @@ The response is:
 
 ### Obtain alignment information
 
+Alignment is returned as a string value of the following format for every word of the source. The information for each word is separated by a space, including for non-space-separated languages (scripts) like Chinese:
+
+[[SourceTextStartIndex]:[SourceTextEndIndex]–[TgtTextStartIndex]:[TgtTextEndIndex]] *
+
+Example alignment string: "0:0-7:10 1:2-11:20 3:4-0:3 3:4-4:6 5:5-21:21".
+
+In other words, the colon separates start and end index, the dash separates the languages, and space separates the words. One word may align with zero, one, or multiple words in the other language, and the aligned words may be non-contiguous. When no alignment information is available, the Alignment element will be empty. The method returns no error in that case.
+
 To receive alignment information, specify `includeAlignment=true` on the query string.
 
 ```curl
@@ -479,9 +487,10 @@ Obtaining alignment information is an experimental feature that we have enabled
 
 * Alignment is not available for text in HTML format i.e., textType=html
 * Alignment is only returned for a subset of the language pairs:
-  - from English to any other language;
-  - from any other language to English except for Chinese Simplified, Chinese Traditional, and Latvian to English;
+  - English to/from any other language except Chinese Traditional, Cantonese (Traditional) or Serbian (Cyrillic).
   - from Japanese to Korean or from Korean to Japanese.
+  - from Japanese to Chinese Simplified and Chinese Simplified to Japanese. 
+  - from Chinese Simplified to Chinese Traditional and Chinese Traditional to Chinese Simplified. 
 * You will not receive alignment if the sentence is a canned translation. Example of a canned translation is "This is a test", "I love you" and other high frequency sentences.
 * Alignment is not available when you apply any of the approaches to prevent translation as described [here](../prevent-translation.md)
 
@@ -511,7 +520,7 @@ The response is:
 
 ### Translate with dynamic dictionary
 
-If you already know the translation you want to apply to a word or a phrase, you can supply it as markup within the request. The dynamic dictionary is only safe for compound nouns like proper names and product names.
+If you already know the translation you want to apply to a word or a phrase, you can supply it as markup within the request. The dynamic dictionary is only safe for proper nouns such as personal names and product names.
 
 The markup to supply uses the following syntax.