Rethinking Documentation Translation: Treating Translations as Versioned Software Assets

Large open-source documentation repositories often suffer from silently accumulating translation issues. These problems arise because documentation constantly changes, leaving translated content out of sync with its source without explicit errors. The Co-op Translator tool now treats translations as versioned software assets, not static outputs. This fundamental shift is inspired by how software dependency managers track evolving sources. By analogy, translations are now viewed as artifacts generated from a specific source version. This approach is particularly relevant for rapidly changing documentation. The system now uses explicit JSON state files to track source versions and synchronization status for all content types. This includes Markdown, images, and notebooks, ensuring consistency across formats. This enables explicit drift detection and provides consistent maintenance signals. It clarifies responsibility by highlighting outdated translations for human review. This model is essential for teams maintaining multilingual documentation that updates frequently. Ultimately, treating translations as versioned assets makes maintenance observable and sustainable.