Merge pull request #6281 from laujan/patch-2

Update create-use-glossaries.md

Author: JamesJBarnett

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

@@ -6,7 +6,7 @@ ms.service: azure-ai-translator
 manager: nitinme
 ms.author: lajanuar
 author: laujan
-ms.date: 04/14/2025
+ms.date: 07/29/2025
 ---
 
 # Use glossaries with Document translation
@@ -19,6 +19,14 @@ A glossary is a list of terms with definitions that you create for the Document
 
 * **Specified translations for ambiguous words**. Choose a specific translation for poly​semantic words.
 
+Translation glossaries are critical tools for maintaining content accuracy across multiple target languages and localization projects. When a glossary is applied during translation, the terms it contains are rendered according to the specified source and target language pair. This process can sometimes affect the overall quality of the translated sentences. Using a glossary may result in the simplification of complex ideas or the omission of subtle nuances, which could lead to misunderstandings or an unintended loss of meaning. To maintain accuracy and consistency in your glossary, it's important to follow these specific steps that ensure the glossary is well-defined and regularly updated:
+
+*    Explicitly specify the source and target languages for each glossary term, along with any relevant localization requirements.
+*    Conduct regular reviews of the glossary to verify term accuracy and relevance, updating entries as necessary.
+*    Provide precise and comprehensive definitions for each term, with particular attention to technical or specialized vocabulary.
+
+
+
 ## Create, upload, and use a glossary file
 
 1. **Create your glossary file.** Create a file in a supported format (preferably tab-separated values) that contains all the terms and phrases you want to use in your translation.

articles/ai-services/translator/toc.yml

@@ -140,6 +140,9 @@ items:
     - name: Use Document translation APIs programmatically
       displayName: get started,batch,sdk,c#,.net,dotnet,python,javascript,java,go,source,target,blob,set up,storage
       href: document-translation/how-to-guides/use-rest-api-programmatically.md
+    - name: Create and use glossaries
+      displayName: glossary, dictionary, case-sensitive, match
+      href: document-translation/how-to-guides/create-use-glossaries.md
   - name: Authentication and authorization
     items:
     - name: Create and use managed identities
@@ -170,9 +173,6 @@ items:
         href: document-translation/reference/get-supported-document-formats.md
       - name: Get supported glossary formats
         href: document-translation/reference/get-supported-glossary-formats.md
-  - name: Create and use glossaries
-    displayName: glossary, dictionary, case-sensitive, match
-    href: document-translation/how-to-guides/create-use-glossaries.md
   - name: Document translation FAQ
     href: document-translation/faq.md
 - name: Containers
@@ -212,15 +212,15 @@ items:
     displayName: use case,usage,train,training,bleu,tuning,tune
     href: custom-translator/azure-ai-foundry/beginners-guide.md
   - name: FAQ
-    href: custom-translator/azure-ai-foundry/faq.md  
+    href: custom-translator/azure-ai-foundry/faq.md
   - name: How-to guides
     items:
     - name: Create an Azure AI Foundry project
       displayName: models,pairs,label,edit,delete
       href: custom-translator/azure-ai-foundry/how-to/create-project.md
     - name: Create a language pair
       displayName: language,language pair,language pair ID,ID
-      href: custom-translator/azure-ai-foundry/how-to/create-language-pair.md  
+      href: custom-translator/azure-ai-foundry/how-to/create-language-pair.md
     - name: Upload data
       displayName: parallel,document sets,tuning,phrase,sentence,upload
       href: custom-translator/azure-ai-foundry/how-to/upload-data.md