Aller au contenu
Alaisia · Éditeurs Un site du réseau Alaisia

Guide

Traduire la documentation d'un logiciel : trois méthodes

Traduction à la main, automatique relue ou assistant multilingue : comparaison, glossaire du produit, mise à jour des versions et qualité des réponses.

Mis à jour le

Trois méthodes existent, et elles se combinent : la traduction humaine, la traduction automatique relue, et l'assistant multilingue qui répond dans la langue de l'utilisateur sans traduire la documentation. Le bon choix dépend moins de la qualité du moteur de traduction que de la fréquence de vos versions : une documentation traduite à la main qui a trois mois de retard induit plus en erreur qu'une documentation absente. Les comparaisons ci-dessous sont des critères de décision, pas des mesures : testez sur vos pages.

Les trois méthodes côte à côte

Traduction à la main Traduction automatique relue Assistant multilingue
Principe Un traducteur travaille chaque page Un moteur traduit, une personne relit La documentation reste dans une langue ; l'assistant répond dans la langue de la question
Qualité attendue La plus régulière, si le traducteur connaît le produit Bonne si le glossaire est imposé et la relecture réelle Variable selon la langue et la question : à mesurer
Mise à jour Lente : chaque changement repasse par une personne Rapide pour la traduction, la relecture reste le goulot Immédiate : la source seule se met à jour
Coût récurrent Le plus élevé Intermédiaire Le plus faible côté contenu, mais des tests à prévoir
Convient pour Mentions légales, sécurité, support contractuel Guides d'usage, tutoriels, notes de version Questions courtes, aide ponctuelle
Risque principal Retard sur la version courante Relecture bâclée, termes incohérents Réponse fluide mais fausse sans que l'utilisateur puisse le voir

Un découpage courant : traduction humaine pour ce qui engage juridiquement, traduction automatique relue pour la documentation d'usage, assistant multilingue pour tout le reste, avec renvoi vers la page source citée.

Le glossaire du produit, avant toute traduction

C'est la pièce qui fait le plus pour la qualité, quelle que soit la méthode. Un tableur à trois colonnes suffit : terme source, terme cible, remarque.

  • Les noms de l'interface : si le bouton s'appelle « Brouillon » dans l'application en français et « Draft » en anglais, la documentation doit dire exactement cela. Une capture d'écran qui ne correspond pas aux mots du texte déroute plus qu'une traduction approximative.
  • Les termes à ne pas traduire : noms de fonctions, de produits, de formats.
  • Les faux amis du métier : un même mot qui veut dire deux choses dans votre domaine (un « mandat », un « compte »), tranché une fois pour toutes.
  • Le ton : vouvoiement ou non, forme impersonnelle ou impérative pour les procédures.

Le glossaire se transmet au traducteur, au moteur de traduction quand il accepte des termes imposés, et à l'assistant dans ses consignes. Un seul document pour les trois.

Tenir les versions à jour

Le problème n'est pas de traduire une fois, c'est de suivre. Une méthode simple :

  1. Découper en unités stables (une page, ou une section) avec un identifiant.
  2. Enregistrer pour chaque traduction la version de la source dont elle est issue (date ou numéro de version).
  3. Comparer à chaque publication : toute unité dont la source est plus récente que sa traduction est marquée « à revoir ».
  4. Afficher l'état à l'utilisateur : une mention « traduction relue le… » ou « traduction automatique, version source plus récente » est plus honnête qu'une page qui prétend être à jour.
  5. Fixer une règle de priorité : les pages les plus lues, ou celles des fonctions modifiées, repassent en premier.

Si vous passez par un assistant, la même discipline s'applique à l'indexation : voir la documentation pour l'IA. Une page périmée, même dans la langue source, produit des réponses périmées.

La qualité d'un assistant dans une autre langue que la documentation

Un assistant peut lire une documentation en français et répondre en espagnol ou en anglais. Cela fonctionne souvent, mais rien ne le garantit pour votre produit : c'est un point à tester, pas à supposer. Méthode proposée :

  • Écrire un jeu de questions (une trentaine pour commencer) par langue visée, par des locuteurs réels, y compris des questions formulées avec du vocabulaire courant et non celui de votre interface.
  • Noter pour chaque réponse : exacte, partiellement exacte, fausse, absente ; et vérifier que le nom des boutons cités correspond à l'interface dans la langue de l'utilisateur.
  • Comparer à la langue source : si l'écart est net, la cause est souvent la terminologie (glossaire absent) plutôt que la compréhension.
  • Imposer la citation de la page source, avec lien, pour que l'utilisateur puisse vérifier.
  • Prévoir la sortie : quand l'assistant n'est pas sûr, il le dit et oriente vers un contact humain dans la langue de l'utilisateur.
  • Refaire le test à chaque changement de modèle ou de documentation importante.

Un point de sécurité à ne pas oublier : l'OWASP, référentiel de sécurité applicative, décrit l'injection de prompt, où un contenu externe modifie le comportement du modèle. Une documentation traduite par un tiers ou importée automatiquement est un contenu externe : relisez ce qui entre dans l'index.

Une décision en quatre questions

  1. Combien de langues vraiment demandées par vos clients, et pour quels contenus ?
  2. À quelle fréquence publiez-vous ? Plus c'est fréquent, plus la traduction manuelle de tout devient intenable.
  3. Quels contenus engagent juridiquement ou concernent la sécurité ? Ceux-là restent en traduction humaine.
  4. Qui relit, et avec quel glossaire ?

Si vous voulez replacer ce choix dans l'ensemble de votre assistant, voir assistant d'aide en ligne. Cette page propose une méthode ; les seuils de qualité acceptables sont à fixer avec vos clients.

Questions fréquentes

Faut-il traduire toute la documentation pour proposer un assistant multilingue ?

Pas forcément. Un assistant peut répondre dans la langue de l'utilisateur à partir d'une documentation dans une autre langue. Il faut alors tester la qualité des réponses sur un jeu de questions dans chaque langue visée, et garder le glossaire du produit.

La traduction automatique relue suffit-elle ?

Souvent pour une documentation d'usage, à condition qu'un relecteur connaisse le produit et que le glossaire soit imposé. Les textes à portée juridique ou de sécurité méritent une traduction humaine.

Comment tenir les traductions à jour à chaque version ?

En traduisant par unités (page, section) et en repérant automatiquement celles dont la source a changé depuis la dernière traduction, pour ne retraduire que celles-là.

Sources

Pages consultées pour écrire cet article :

  1. https://genai.owasp.org/llmrisk/llm01-prompt-injection/

À lire aussi