Крупные репозитории с открытым исходным кодом часто страдают от тихо накапливающихся проблем с переводом. Эти проблемы возникают из-за постоянного изменения документации, оставляя переведённый контент несинхронизированным с исходным источником без явных ошибок. Инструмент Co-op Translator теперь рассматривает переводы как версионные программные ресурсы, а не статические выходы. Этот фундаментальный сдвиг вдохновлён тем, как менеджеры программных зависимостей отслеживают меняющиеся источники. По аналогии, переводы теперь рассматриваются как артефакты, созданные из определённой версии источника. Этот подход особенно актуален для быстро меняющейся документации. Теперь система использует явные JSON-файлы состояния для отслеживания исходных версий и статуса синхронизации всех типов контента. Это включает Markdown, изображения и блокноты, обеспечивающие согласованность между форматами. Это позволяет явно обнаруживать дрейф и обеспечивает стабильные сигналы обслуживания. Он проясняет ответственность, выделяя устаревшие переводы для проверки людьми. Эта модель необходима командам, поддерживающим многоязычную документацию, которая регулярно обновляется. В конечном итоге, рассматривая переводы как версионные ресурсы, обслуживание становится наблюдаемым и устойчивым.
techcommunity.microsoft.com
Rethinking Documentation Translation: Treating Translations as Versioned Software Assets
