Concevoir un pipeline de traduction
Transformez les modifications de la source en traductions utilisables, avec des responsabilités, une relecture, une livraison et une reprise clairement définies.
Un pipeline de traduction est complet lorsqu’une modification de la source devient du contenu utilisable dans le système qui en a besoin. La Génération n’est qu’une partie du processus. Le workflow doit aussi identifier la bonne révision, récupérer les traductions cibles correspondantes, préserver le travail accepté et déterminer ce qui peut être publié.
Commencez par concevoir le pipeline pour une catégorie de contenu concrète : catalogues dans un dépôt, articles de CMS ou enregistrements d’application. Chaque catégorie a ses propres responsables et modes de livraison. Les traiter toutes de la même façon dans un workflow peut masquer les décisions qui déterminent si un résultat peut être utilisé en toute sécurité.
Définissez les responsabilités à chaque transition #
Pour des catalogues dans un dépôt, le workflow pourrait reposer sur les choix suivants :
| Transition | Décision |
|---|---|
| La source devient admissible | Traduire la source relue correspondant à un commit consigné, via un déclencheur de confiance qui exclut les traductions cibles générées. |
| Le travail commence | Utiliser le moteur de localisation, les langues, le format et les versions de référence acceptées explicitement définis ; obtenir l’approbation de l’exécution lorsqu’elle est requise. |
| Les traductions cibles deviennent acceptables | Les personnes désignées pour la relecture examinent les modifications requises, et les cas non résolus restent visibles. |
| Le résultat est récupéré | Les ressources téléchargées et validées sont intégrées à une pull request de traduction. |
| Le contenu parvient au lectorat | La version de l’application accepte la modification et réussit les contrôles de ses ressources. |
| Un résultat doit être annulé | Restaurer les ressources dont la validité est établie, ainsi que la configuration ou les versions de référence concernées. |
Il s’agit d’un exemple de workflow, et non du fonctionnement par défaut du produit. Précisez le mécanisme concret qui fait appliquer chaque décision. Si une règle d’équipe ne fait l’objet d’aucun contrôle automatique, une personne doit être désignée pour en vérifier le respect.
Choisissez les outils selon leurs responsabilités #
Une intégration native peut prendre en charge les déclencheurs du fournisseur et l’écriture des résultats dans le système d’origine, dans les limites des autorisations accordées à son installation. Un exécuteur CLI prend en charge la récupération locale et les commits. Le système qui appelle l’API est responsable des révisions qu’il stocke et de l’activation des résultats. Choisissez les contrats pris en charge qui correspondent à ces responsabilités.
Studio gère la configuration de traduction et les décisions ; DevTools permet l’exécution par programmation et sur fichiers ; Radar fournit les éléments disponibles pour la mesure et l’investigation. Ces capacités se combinent : ce ne sont pas des étapes à adopter obligatoirement l’une après l’autre.
Consultez la documentation du fournisseur choisi sur les modes manuels et automatiques, la gestion des brouillons, les droits d’accès et les conséquences d’une déconnexion. Une connexion qui publie dans un CMS et une connexion qui ouvre une pull request dans un dépôt n’ont pas le même point d’acceptation.
Préservez le lien entre les révisions #
Conservez ensemble l’identité du contenu, la révision source, la langue cible, la révision ou l’artefact de sortie, la configuration et l’acceptation. Définissez ce qui se passe si une source plus récente arrive pendant la traduction ou la relecture. Le résultat de l’ancienne source ne doit pas devenir la version courante simplement parce que son traitement se termine en dernier.
Déterminez où la réutilisation préserve les traductions cibles acceptées et où une nouvelle génération est souhaitée. La prise en charge d’un même format ne garantit pas des options identiques dans l’API, la CLI et l’application. Intégrez à la conception la version de référence exacte du système appelant et le comportement de forçage.
Anticipez les cas non résolus #
Définissez la marche à suivre après le rejet des données d’entrée, l’échec d’une traduction cible, une interruption de la récupération, une attente de relecture, un conflit local ou une réponse incertaine. L’action suivante doit récupérer le travail connu dans le cadre du contrat qui le régit, et non tout recommencer parce qu’un accusé de réception a été perdu.
Certaines traductions cibles terminées peuvent être mises en attente alors qu’une autre reste non résolue. Décidez si la publication les exige toutes ou peut délibérément recourir à une solution de repli. La politique de relecture définit les conséquences des décisions manquantes et des délais dépassés. Laissez les contrôles d’exécution à l’outil responsable du travail plutôt que d’inventer une action universelle de nouvelle tentative.
Rendez les preuves de qualité interprétables #
Définissez les questions qui comptent pour la publication, y compris pour les traductions produites en dehors de Lingo.dev. Une mesure peut repérer le travail qui nécessite une relecture sans pour autant devenir le système responsable du contenu accepté ou des décisions de publication.
La conception des mesures explique les critères, les éléments probants, les états des réponses et les populations couvertes par les rapports. Dans le cadre du workflow, désignez les personnes qui interprètent ces éléments et lèvent les incertitudes sur le sens de la source.
Validez un cycle complet avant d’élargir le périmètre #
Faites parcourir à une modification de la source toutes les étapes : soumission, récupération, validation, relecture, livraison et utilisation. Lors d’un essai sans risque, modifiez la source pendant le traitement et simulez l’échec d’une traduction cible. Vérifiez que la révision courante reste identifiable et que la reprise préserve les résultats acceptés.
Utilisez un essai du workflow pour consigner ce qui a réellement été exécuté et ce qui reste à tester. La conception est prête à être étendue lorsqu’une autre personne chargée des opérations peut expliquer à la fois comment une traduction devient utilisable et comment revenir à l’état utilisable précédent.