updating from release branch

Author: melghazali

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

@@ -1,32 +1,32 @@
 ---
-title: Azure AI Translator Custom Translation for beginners
+title: Azure AI Translator custom translation for beginners
 titleSuffix: Azure AI services
-description: A 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
 ms.author: lajanuar
-ms.date: 01/27/2025
+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](../reference/v3-0-translate.md?tabs=curl) service that powers billions of translations every day.
+ [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.
 
-[Custom Translation](overview.md) empowers you to build a translation system that truly captures your business's unique language, industry terminology, and domain-specific style. With an intuitive interface, training, testing, and deploying your custom model is simple and requires no programming expertise. Seamlessly integrate your tailored translation system into your existing applications, workflows, and websites—all backed by the cloud-based [Azure AI Translator Text Translation API](../reference/v3-0-translate.md?tabs=curl) service that powers billions of translations each day.
+[Custom translation](overview.md) empowers you to build a translation system that truly captures your business's unique language, industry terminology, and domain-specific style. With an intuitive interface, training, testing, and deploying your custom model is simple and requires no programming expertise. Seamlessly integrate your tailored translation system into your existing applications, workflows, and websites—all backed by the cloud-based [Azure AI Translator Text Translation API](../../text-translation/reference/v4/translate-api.md?tabs=curl) service that powers billions of translations each day.
 
-The platform enables users to build and publish custom translation systems to and from English. The Custom Translator supports more than 100 languages that map directly to the languages available for Neural machine translation (NMT). For a complete list, *see* [Translator language support](../language-support.md).
+The platform enables users to build and publish custom translation systems to and from English. The Custom Translator supports more than 100 languages that map directly to the languages available for Neural machine translation (NMT). For a complete list, *see* [Translator language support](../../../language-support.md).
 
 ## Is a custom translation model the right choice for you?
 
-A well-trained custom translation model excels at delivering accurate, domain-specific translations by learning from your previously translated in-domain documents. This approach ensures that your specialized terms and phrases are used in context, producing fluent, natural translations that respect the target language’s grammatical nuances.
+A well-trained custom translation model excels at delivering accurate, domain-specific translations by learning from your previously translated in-domain documents. This approach ensures that your specialized terms and phrases are used in context, producing fluent, natural translations that respect the target language's grammatical nuances.
 
-Keep in mind that developing a full custom translation model requires a substantial amount of training data—typically at least 10,000 parallel sentences. If you don’t have enough data to train a comprehensive model, you might consider building a dictionary-only model to capture essential terminology, or you can rely on the high-quality, out-of-the-box translations offered by the Text Translation API.
+Keep in mind that developing a full custom translation model requires a substantial amount of training data—typically at least 10,000 parallel sentences. If you don't have enough data to train a comprehensive model, you might consider building a dictionary-only model to capture essential terminology, or you can rely on the high-quality, out-of-the-box translations offered by the Text Translation API.
 
-Ultimately, if you need translations that reflect your industry’s specific language and you have ample training resources, a custom translation model can be the ideal choice for your organization.
+Ultimately, if you need translations that reflect your industry's specific language and you have ample training resources, a custom translation model can be the ideal choice for your organization.
 
-:::image type="content" source="media/how-to/for-beginners.png" alt-text="Screenshot illustrating the difference between custom and general models.":::
+:::image type="content" source="../media/how-to/for-beginners.png" alt-text="Screenshot illustrating the difference between custom and general models.":::
 
 ## What does training a custom translation model involve?
 
@@ -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?
 
@@ -163,4 +163,4 @@ After your model is successfully trained, you can view the model's BLEU score an
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Try create project](../azure-ai-foundry/how-to-custom-translation-create-project.md)
+> [Try create project](../azure-ai-foundry/how-to/create-project.md)

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

@@ -1,47 +1,35 @@
 ---
-title: "What is a BLEU score? - Custom Translation"
+title: Azure AI Foundry custom translation BLEU score
 titleSuffix: Azure AI services
-description: BLEU is a measurement of the differences between machine translation and human-created reference translations of the same source sentence.
+description: The BLEU score measures the differences between machine translation and human-created reference translations of the same source sentence.
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: conceptual
-ms.date: 01/27/2025
+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.
 ---
 
-# What is a 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.
+For 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.
 
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [BLEU score evaluation](../how-to-custom-translation-test-model.md)
+> [BLEU score evaluation](../how-to/test-model.md)

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

@@ -1,23 +1,23 @@
 ---
-title: Translation Customization - Custom Translation
+title: Azure AI Foundry custom translations
 titleSuffix: Azure AI services
-description: Use the Microsoft Translator Hub to build your own machine translation system using your preferred terminology and style.
+description: Build your own machine translation system using your preferred terminology and style.
 #services: cognitive-services
 author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: conceptual
-ms.date: 01/28/2025
+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).
+The feature can also be used to customize speech translation when used with [Azure AI Speech](../../../../speech-service/index.yml).
 
-## Custom Translation
+## Custom translation
 
 With Custom Translator, you can build neural translation systems that understand the terminology used in your own business and industry. The customized translation system integrates into existing applications, workflows, and websites.
 
@@ -31,9 +31,9 @@ The customized system is then available through a regular call to Translator usi
 
 Given the appropriate type and amount of training data it isn't uncommon to expect gains between 5 and 10, or even more `BLEU` points on translation quality by using Custom Translator.
 
-More details about the various levels of customization based on available data can be found in the [Custom Translation User Guide](../overview.md).
+More details about the various levels of customization based on available data can be found in the [Custom translation User Guide](../overview.md).
 
 ## 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)