From c3593298801a5386325f3c1605473c2f1f11b62d Mon Sep 17 00:00:00 2001 From: Minseok Song <99078115+skytin1004@users.noreply.github.com> Date: Wed, 4 Feb 2026 17:43:06 +0900 Subject: [PATCH] Clarify translation management in README Enhanced clarity and consistency in the README regarding how Co-op Translator manages translations and metadata. --- README.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index df4392aa..d3d84fd9 100644 --- a/README.md +++ b/README.md @@ -52,21 +52,24 @@ Example of how translated content is organized: ## How translation state is managed -Co-op Translator manages translated content as versioned artifacts, -not static files. +Co-op Translator manages translated content as **versioned software artifacts**, +not as static files. -Co-op Translator tracks the freshness of translated Markdown, -images, and notebooks using language-scoped state metadata. +The tool tracks the state of translated Markdown, images, and notebooks +using **language-scoped metadata**. -This design allows the tool to: +This design allows Co-op Translator to: - Reliably detect outdated translations - Treat Markdown, images, and notebooks consistently -- Avoid fragile inline markers inside content -- Scale safely across large, multi-language repositories +- Scale safely across large, fast-moving, multi-language repositories + +By modeling translations as managed artifacts, +translation workflows align naturally with modern +software dependency and artifact management practices. + +→ [How translation state is managed](https://techcommunity.microsoft.com/blog/azuredevcommunityblog/rethinking-documentation-translation-treating-translations-as-versioned-software/4491755) -This approach aligns translation workflows with modern software -dependency and artifact management practices. ## Quick start