azure ai foundry references

Author: laujan

articles/ai-services/translator/custom-translator/azure-ai-foundry/beginners-guide.md

@@ -1,7 +1,7 @@
 ---
-title: Azure AI Translator Custom translation for beginners
+title: Azure AI Translator custom translation for beginners
 titleSuffix: Azure AI services
-description: User guide for understanding the end-to-end customized machine translation process.
+description: User guide for understanding the end-to-end customized machine translation process using Azure AI Foundry.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
@@ -10,7 +10,7 @@ ms.date: 05/19/2025
 ms.topic: overview
 ---
 
-# Azure AI Translator Custom translation for beginners
+# Azure AI Translator custom translation for beginners
 
  [Custom translation](overview.md) enables you to a build translation system that reflects your business, industry, and domain-specific terminology and style. Training and deploying a custom system is easy and doesn't require any programming skills. The customized translation system seamlessly integrates into your existing applications, workflows, and websites and is available on Azure through the same cloud-based [Microsoft Text Translation API](../../text-translation/reference/v4/translate-api.md) service that powers billions of translations every day.
 
@@ -76,15 +76,15 @@ Finding in-domain quality data is often a challenging task that varies based on
 
 ## What is a BLEU score?
 
-BLEU (Bilingual Evaluation Understudy) is an algorithm for evaluating the precision or accuracy of text that is machine translated from one language to another. Custom translation uses the BLEU metric as one way of conveying translation accuracy.
+BLEU (Bilingual Evaluation Understudy) is an algorithm for evaluating the precision or accuracy of text that is machine translated from one language to another. custom translation uses the BLEU metric as one way of conveying translation accuracy.
 
 A BLEU score is a number between zero and 100. A score of zero indicates a low quality translation where nothing in the translation matched the reference. A score of 100 indicates a perfect translation that is identical to the reference. It's not necessary to attain a score of 100 - a BLEU score between 40 and 60 indicates a high-quality translation.
 
 [Read more](concepts/bleu-score.md?WT.mc_id=aiml-43548-heboelma)
 
 ## What happens if I don't submit tuning or testing data?
 
-Tuning and test sentences are optimally representative of what you plan to translate in the future. If you don't submit any tuning or testing data, Custom translation automatically excludes sentences from your training documents to use as tuning and test data.
+Tuning and test sentences are optimally representative of what you plan to translate in the future. If you don't submit any tuning or testing data, custom translation automatically excludes sentences from your training documents to use as tuning and test data.
 
 | System-generated | Manual-selection |
 |---|---|
@@ -93,13 +93,13 @@ Tuning and test sentences are optimally representative of what you plan to trans
 | Easy to redo when you grow or shrink the domain. | Allows for more data and better domain coverage.|
 |Changes each training run.| Remains static over repeated training runs|
 
-## How is training material processed by Custom translation?
+## How is training material processed by custom translation?
 
-To prepare for training, documents undergo a series of processing and filtering steps. Knowledge of the filtering process can help with understanding the sentence count displayed as well as the steps you can take to prepare training documents for training with Custom translation. The filtering steps are as follows:
+To prepare for training, documents undergo a series of processing and filtering steps. Knowledge of the filtering process can help with understanding the sentence count displayed as well as the steps you can take to prepare training documents for training with custom translation. The filtering steps are as follows:
 
 * ### Sentence alignment
 
-  If your document isn't in `XLIFF`, `XLSX`, `TMX`, or `ALIGN` format, Custom translation aligns the sentences of your source and target documents to each other, sentence-by-sentence. Translator doesn't perform document alignment—it follows your naming convention for the documents to find a matching document in the other language. Within the source text, Custom translation tries to find the corresponding sentence in the target language. It uses document markup like embedded HTML tags to help with the alignment.
+  If your document isn't in `XLIFF`, `XLSX`, `TMX`, or `ALIGN` format, custom translation aligns the sentences of your source and target documents to each other, sentence-by-sentence. Translator doesn't perform document alignment—it follows your naming convention for the documents to find a matching document in the other language. Within the source text, custom translation tries to find the corresponding sentence in the target language. It uses document markup like embedded HTML tags to help with the alignment.
 
   If you see a large discrepancy between the number of sentences in the source and target documents, your source document can't be parallel, or couldn't be aligned. The document pairs with a large difference (>10%) of sentences on each side warrant a second look to make sure they're indeed parallel.
 
@@ -139,11 +139,11 @@ To prepare for training, documents undergo a series of processing and filtering
 
 * ### Invalid characters
 
-  Custom translation removes sentences that contain Unicode character U+FFFD. The character U+FFFD indicates a failed encoding conversion.
+  custom translation removes sentences that contain Unicode character U+FFFD. The character U+FFFD indicates a failed encoding conversion.
 
 * ### Invalid HTML tags
 
-  Custom translation removes valid tags during training. Invalid tags cause unpredictable results and should be manually removed. 
+  custom translation removes valid tags during training. Invalid tags cause unpredictable results and should be manually removed. 
 
 ## What steps should I take before uploading data?
 

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

@@ -1,5 +1,5 @@
 ---
-title: "BLEU score - Custom translation"
+title: Azure AI Foundry custom translation BLEU score
 titleSuffix: Azure AI services
 description: The BLEU score measures the differences between machine translation and human-created reference translations of the same source sentence.
 author: laujan
@@ -9,34 +9,22 @@ ms.topic: conceptual
 ms.date: 05/19/2025
 ms.author: lajanuar
 ms.custom: cogserv-non-critical-translator
-#Customer intent: As an Custom translation user, I want to understand how BLEU score works so that I understand system test outcome better.
+#Customer intent: As an custom translation user, I want to understand how BLEU score works so that I understand system test outcome better.
 ---
 
-# BLEU score
+# Azure AI Foundry custom translation BLEU score
 
 [BLEU (Bilingual Evaluation Understudy)](https://en.wikipedia.org/wiki/BLEU) is a measurement of the difference between an automatic translation and human-created reference translations of the same source sentence.
 
 ## Scoring process
 
-The BLEU algorithm compares consecutive phrases of the automatic translation
-with the consecutive phrases it finds in the reference translation, and counts
-the number of matches, in a weighted fashion. These matches are position
-independent. A higher match degree indicates a higher degree of similarity with
-the reference translation, and higher score. Intelligibility and grammatical correctness aren't taken into account.
+The BLEU algorithm compares consecutive phrases of the automatic translation with the consecutive phrases it finds in the reference translation, and counts the number of matches, in a weighted fashion. These matches are position independent. A higher match degree indicates a higher degree of similarity with the reference translation, and higher score. Intelligibility and grammatical correctness aren't taken into account.
 
 ## How BLEU works?
 
-The BLEU score's strength is that it correlates well with human judgment. BLEU averages out
-individual sentence judgment errors over a test corpus, rather than attempting
-to devise the exact human judgment for every sentence.
+The BLEU score's strength is that it correlates well with human judgment. BLEU averages out individual sentence judgment errors over a test corpus, rather than attempting to devise the exact human judgment for every sentence.
 
-A more extensive discussion of BLEU scores is [here](https://youtu.be/-UqDljMymMg).
-
-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 are trained within a narrow domain, and
-your training data is consistent with your test data, you can expect a high
-BLEU score.
+A more extensive discussion of BLEU scores *see* [Microsoft Translator Hub - Discussion of BLEU Score](https://youtu.be/-UqDljMymMg). 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 are trained within a narrow domain, and your training data is consistent with your test data, you can expect a high BLEU score.
 
 >[!NOTE]
 >A comparison between BLEU scores is only justifiable when BLEU results are compared with the same Test set, the same language pair, and the same MT engine. A BLEU score from a different test set is bound to be different.

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

@@ -1,5 +1,5 @@
 ---
-title: Translation Customization - Custom translation
+title: Azure AI Foundry custom translations
 titleSuffix: Azure AI services
 description: Build your own machine translation system using your preferred terminology and style.
 #services: cognitive-services
@@ -11,9 +11,9 @@ ms.date: 05/19/2025
 ms.author: lajanuar
 ---
 
-# Customize your text translations
+# Azure AI Foundry custom translations
 
-Custom translation is a feature of the Azure AI Translator service. Custom translation allows users to customize Azure AI Translator's advanced neural machine translation when translating text using Translator (version 3 only).
+Custom translation is a feature of the Azure AI Translator service. Azure AI Foundry custom translation allows users to customize Azure AI Translator's advanced neural machine translation when translating text using Translator (version 3 only).
 
 The feature can also be used to customize speech translation when used with [Azure AI Speech](../../../../speech-service/index.yml).
 
@@ -36,4 +36,4 @@ More details about the various levels of customization based on available data c
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Set up a customized language system using Custom translation](../overview.md)
+> [Set up a customized language system using custom translation](../overview.md)

articles/ai-services/translator/custom-translator/azure-ai-foundry/concepts/data-filtering.md

@@ -1,30 +1,30 @@
 ---
-title: "Data Filtering - Custom translation"
+title: Azure AI Foundry custom translation data filtering
 titleSuffix: Azure AI services
-description: Explaining how training documents for a custom system undergo a series of processing and filtering steps.
+description: How custom transltation training documents for a custom system undergo a series of processing and filtering steps.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.date: 05/19/2025
 ms.author: lajanuar
 ms.topic: conceptual
 ms.custom: cogserv-non-critical-translator
-#Customer intent: As a Custom translation, I want to understand how data is filtered before training a model.
+#Customer intent: As a custom translation, I want to understand how data is filtered before training a model.
 ---
 
-# Custom translation Data filtering
+# Azure AI Foundry custom translation data filtering
 
-When you submit documents to be used for training, the documents undergo a series of processing and filtering steps. These steps are explained here. The knowledge of the filtering can help you understand the sentence count displayed in Custom translation and the steps you can take yourself to prepare the documents for training with Custom translation.
+When you submit documents to be used for training, the documents undergo a series of processing and filtering steps. These steps are explained here. The knowledge of the filtering can help you understand the sentence count displayed in custom translation and the steps you can take yourself to prepare the documents for training with custom translation.
 
 ## Sentence alignment
 
-If your document isn't in XLIFF, `TMX`, or ALIGN format, Custom translation aligns the sentences of your source and target documents to each other, sentence by sentence. Custom translation doesn't perform document alignment – it follows your naming of the documents to find the matching document of the other language. Within the document, Custom translation tries to find the corresponding sentence in the other language. It uses document markup like embedded HTML tags to help with the alignment.
+If your document isn't in XLIFF, `TMX`, or ALIGN format, custom translation aligns the sentences of your source and target documents to each other, sentence by sentence. custom translation doesn't perform document alignment – it follows your naming of the documents to find the matching document of the other language. Within the document, custom translation tries to find the corresponding sentence in the other language. It uses document markup like embedded HTML tags to help with the alignment.
 
-If you see a large discrepancy between the number of sentences in the source and target documents, your documents can't be parallel. The document pairs with a large difference (>10%) of sentences on each side warrant a second look to make sure they're indeed parallel. Custom translation shows a warning next to the document if the sentence count differs suspiciously.
+If you see a large discrepancy between the number of sentences in the source and target documents, your documents can't be parallel. The document pairs with a large difference (>10%) of sentences on each side warrant a second look to make sure they're indeed parallel. custom translation shows a warning next to the document if the sentence count differs suspiciously.
 
 ## Deduplication
 
-Custom translation removes the sentences that are present in test and tuning documents from training data. The removal happens dynamically inside of the training run, not in the data processing step. Custom translation reports the sentence count to you in the project overview before such removal. Deduplication doesn't apply if you choose to upload your own test and tuning documents.
+Custom translation removes the sentences that are present in test and tuning documents from training data. The removal happens dynamically inside of the training run, not in the data processing step. custom translation reports the sentence count to you in the project overview before such removal. Deduplication doesn't apply if you choose to upload your own test and tuning documents.
 
 ## Length filter
 

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

@@ -1,7 +1,7 @@
 ---
-title: "Dictionary - Custom translation"
+title: Azure AI Foundry custom translation dictionary
 titleSuffix: Azure AI services
-description: How to create an aligned document specifying a list of phrases or sentences (and their translations) that you always want Azure AI Translator to translate in the same manner. Dictionaries can also be called glossaries or term bases.
+description: How to create an Azure AI Foundry custom translation dictionary specifying a list of phrases or sentences (and their translations) that you want Azure AI Translator to always translate in the same manner. Dictionaries can also be called glossaries or term bases.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
@@ -12,9 +12,9 @@ ms.custom: cogserv-non-critical-translator
 #Customer intent: As a Custom Translator, I want to understand how to use a dictionary to build a custom translation model.
 ---
 
-# Dictionary
+# Azure AI Foundry custom translation dictionary
 
-A custom translation dictionary is an aligned pair of documents that specifies a list of phrases or sentences and their corresponding translations. Use a dictionary in your training, when you want Custom Translator to translate any instances of the source phrase or sentence, using the translation you provide in the dictionary. Dictionaries are sometimes called glossaries or term bases. You can think of the dictionary as a brute force "copy and replace" for all the terms you list. Furthermore, Custom translation service builds and makes use of its own general purpose dictionaries to improve the quality of its translation. However, a customer provided dictionary takes precedent and is searched first to look up words or sentences.
+A custom translation dictionary is an aligned pair of documents that specifies a list of phrases or sentences and their corresponding translations. Use a dictionary in your training, when you want Custom Translator to translate any instances of the source phrase or sentence, using the translation you provide in the dictionary. Dictionaries are sometimes called glossaries or term bases. You can think of the dictionary as a brute force "copy and replace" for all the terms you list. Furthermore, custom translation service builds and makes use of its own general purpose dictionaries to improve the quality of its translation. However, a customer provided dictionary takes precedent and is searched first to look up words or sentences.
 
 Dictionaries only work for projects in language pairs that have a fully supported Microsoft general neural network model behind them. [View the complete list of languages](../../../language-support.md).