Pourquoi nous avons créé Localizeflow
Updated: 11/28/2025 · 4 min read
La documentation technique nécessite plus qu'une simple traduction. Elle requiert une pipeline automatisée qui préserve la structure, le contexte et la cohérence entre les langues.
La documentation technique est un système vivant
La documentation technique évolue continuellement à mesure qu’un produit évolue.
Chaque ajout de fonctionnalité, mise à jour ou modification d’API nécessite des mises à jour de la documentation, et ces mises à jour doivent être reflétées dans toutes les langues, pas seulement dans la source originale.
Traduire le texte est la partie facile.
Maintenir les versions traduites constamment à jour est le vrai défi.
En pratique, maintenir une documentation multilingue introduit un flux de travail constant :
- suivre les pages qui ont changé
- identifier les sections nécessitant une retraduction
- s’assurer que les blocs de code, HTML, frontmatter et la mise en forme restent intacts
- préparer des PR propres pour relecture
- gérer des structures de répertoires de plus en plus complexes
Plus la documentation est volumineuse, plus ce fardeau opérationnel devient lourd.
Après avoir géré plusieurs projets de documentation moi-même, une conclusion est devenue impossible à ignorer :
Il est plus difficile de maintenir la documentation que de la traduire.
FastAPI a rendu le problème visible pour tous
En 2025, l’équipe FastAPI a annoncé qu’elle cesserait de s’appuyer sur des PR de traduction dirigées par la communauté et passerait à un pipeline interne automatisé.
C’était révélateur.
Le problème ne se limitait pas à un grand projet open source. Il reflétait une difficulté universelle rencontrée par toute équipe maintenant une documentation multilingue.
Les grands projets peuvent se permettre de construire des systèmes internes.
La plupart des équipes, des mainteneurs OSS de petite taille, et des startups en phase initiale ne le peuvent pas.
Localizeflow a été créé pour répondre à cette réalité.
Nous avions besoin d’un pipeline, pas d’un autre outil de traduction
Localizeflow n’a jamais été conçu pour être un simple traducteur.
Ce que nous voulions, c’est un système où chaque étape déclenchée par une mise à jour de la documentation s’exécute automatiquement dans GitHub :
- mettre à jour un document et seuls les langages nécessaires sont régénérés
- la structure Markdown est préservée
- code, HTML et frontmatter restent intacts
- les images sont scannées et traduites
- les résultats apparaissent sous forme de PR propre prête à la relecture
Une seule installation d’application GitHub.
Aucun script personnalisé.
Aucune gestion manuelle des répertoires.
Un pipeline complet qui s’active à chaque modification de documentation.
Pourquoi nous régénérons au niveau de la structure du document
La plupart des outils de traduction fonctionnent au niveau de la phrase.
La documentation technique n’est pas une liste de phrases. C’est une combinaison structurée de Markdown, métadonnées, exemples de code, diagrammes et modèles.
Localizeflow évalue les changements au niveau de la structure du document et régénère la sortie en conséquence.
La différence peut être plus large parfois, mais les bénéfices sont clairs :
- terminologie cohérente
- contexte préservé
- structure de document stable
Dans plusieurs projets réels, cette méthode s’est avérée bien plus fiable.
Construit sur le moteur Co-op Translator
Localizeflow est propulsé par le moteur Co-op Translator.
Ce système a été développé à travers plus d’un an de traduction et de maintenance de documentation GitHub réelle.
Ce n’est pas un simple wrapper autour d’une API.
C’est un moteur testé en production utilisé dans plusieurs pipelines de documentation open source de Microsoft aujourd’hui.
Il inclut :
- analyse robuste de Markdown
- préservation de code, HTML et frontmatter
- traduction de diagrammes Mermaid
- extraction et traduction de texte dans les images
- fonctionnalités de cohérence terminologique et contextuelle
Ces capacités ont été développées parce que les workflows de documentation réels en avaient besoin.
Avec la diffusion d’outils de documentation tels que Astro, Hugo et Docusaurus, le volume et la complexité du contenu continuent de croître.
Maintenir la documentation à jour est devenu un avantage produit.
Localizeflow existe parce que ce besoin est désormais fondamental.
La langue reste une barrière dans la tech
Exploiter Co-op Translator a révélé une vérité claire.
Beaucoup de développeurs ne peuvent toujours pas accéder à une documentation de haute qualité dans leur propre langue.
La documentation fait partie intégrante du produit.
Si l’information est retardée ou difficile d’accès, l’apprentissage ralentit, les boucles de rétroaction s’allongent et l’adoption du produit diminue.
La mission de Localizeflow est simple :
Aucune équipe ne devrait avoir à construire son propre système de traduction.
Que ce soit DevRel, les équipes de documentation, les entreprises SaaS, les mainteneurs OSS ou les startups en phase initiale, une mise à jour de documentation devrait automatiquement mettre à jour toutes les langues, régénérer uniquement les changements nécessaires et produire une PR unique pour relecture.
Localizeflow existe pour supprimer le point de rupture
La plupart des équipes abandonnent finalement le maintien de la documentation multilingue.
À mesure que la documentation croît et que les mises à jour se multiplient, les traductions prennent rapidement du retard.
Localizeflow vise à supprimer ce point de rupture.
Il ne rend pas seulement la traduction plus facile.
Il rend la maintenance de la documentation traduite durable.