Collecter des traductions pour les mesurer

Choisissez une source prise en charge et conservez le texte, les révisions et le contexte nécessaires à une mesure.

Vous pouvez commencer par mesurer les traductions que votre équipe produit déjà. Conservez le dépôt ou le système de gestion des traductions comme référence pour les textes acceptés, puis choisissez comment les rendre accessibles à une vérification.

L’essentiel est de disposer d’une version identifiable. Si un message change après son évaluation, la réponse précédente reste valable pour la formulation précédente. Conserver ensemble les révisions source et cible permet à l’équipe de retrouver les éléments de preuve plutôt que de les reconstituer à partir du contenu le plus récent.

Choisir la source adaptée à votre workflow #

Point de départMéthode de mesure
Activité CrowdinConnectez Crowdin, configurez une mesure sur les événements, puis examinez l’événement Radar et la réponse obtenus. L’accès à Radar est nécessaire pour consulter ses écrans.
Commits GitHubConnectez la GitHub App et configurez les chemins source et cible. Les modifications apportées aux clés de localisation prises en charge sur la branche par défaut génèrent des événements.
Centre d’aide ZendeskConnectez Zendesk. Les modifications apportées aux articles publiés génèrent des événements source ou de traduction dans leurs langues respectives.
Fichiers de traduction locauxUtilisez lingo score avec un évaluateur et un modèle configurés. Les résultats sont enregistrés localement, en dehors de l’historique des événements Radar.
Traductions Lingo.devChaque localisation terminée constitue déjà un événement. Le guide Relecture des traductions Lingo.dev explique comment sélectionner les moteurs, les langues et un échantillon.

Pour toute autre source, contactez Lingo.dev afin d’organiser la collecte des événements avant d’automatiser leur transmission.

Collecter l’activité GitHub et Zendesk #

Pour GitHub, installez la GitHub App pour le dépôt concerné et connectez-la à l’organisation Lingo.dev. Committez .lingo/config.json en y indiquant la langue source, les langues cibles et les motifs de correspondance des fichiers source. Ces chemins permettent de distinguer les modifications du texte source de celles des traductions. Examinez un événement après qu’un commit sur la branche par défaut a modifié une clé de localisation configurée ; un même commit peut générer des événements pour plusieurs clés et plusieurs langues.

La collecte GitHub lit les fichiers JSON, JSONC, YAML, YAML avec une clé racine, les ressources Android, ainsi que les fichiers Apple .strings, Flutter ARB, PHP et TypeScript. Le guide Modifications du dépôt explique comment les modifications génèrent des événements.

Pour Zendesk, autorisez la connexion au centre d’aide et activez ses langues. Radar enregistre l’activité des articles publiés, par langue. Ouvrez l’événement et comparez l’identité de l’article, la langue et le texte avec les informations dans Zendesk. La collecte de l’activité ne déclenche pas à elle seule une synchronisation des traductions et ne publie pas de nouvel article cible.

Les deux connexions conservent les traductions acceptées dans leur système d’origine. Une mesure examine les événements enregistrés sans se substituer à l’étape de publication.

Importer l’historique du fournisseur avant de le mesurer #

Choisissez l’historique du fournisseur dont vous avez besoin :

  • GitHub : importe jusqu’aux 5 000 derniers commits de la branche par défaut du dépôt. Chaque commit est lu avec le .lingo/config.json enregistré à cette révision. Les commits antérieurs à la création de cette configuration ne génèrent aucun événement.
  • Zendesk : importe, dans chaque langue, les versions actuellement publiées des articles, sections et catégories existants, avec la date de leur dernière mise à jour. Cette collecte n’inclut ni les révisions antérieures ni les brouillons.

Les nouvelles connexions GitHub et Zendesk lancent automatiquement un import de l’historique. Suivez sa progression dans l’onglet Paramètres de la connexion. Pour lancer un import ou réessayer ultérieurement :

  1. Dans Studio, sélectionnez le dépôt ou le centre d’aide sous Connecté, puis ouvrez son onglet Paramètres.
  2. Sous Historique des commits pour GitHub ou Historique du centre d’aide pour Zendesk, sélectionnez Importer l’historique.
  3. Suivez la progression de l’import, qui indique le nombre d’éléments du fournisseur en attente de collecte.
  4. Attendez que les événements à mesurer apparaissent dans Radar → Journaux, puis examinez leurs dates, leurs langues et leur texte.

Pour une mesure exécutée sur les événements des fournisseurs, l’onglet Remplissage rétroactif propose aussi l’option Importer des événements, avec les dépôts GitHub et les centres d’aide Zendesk connectés. L’historique est importé sans exécuter de mesures. Une fois les événements souhaités visibles, activez la mesure et lancez une évaluation historique sur la période correspondante.

Si d’autres événements importés apparaissent après le remplissage rétroactif, exécutez-le à nouveau en activant Uniquement les événements pas encore mesurés. Si l’import échoue, examinez sa progression et réessayez depuis le même onglet Paramètres. Vérifiez séparément l’import, le remplissage rétroactif de la mesure et ses résultats.

Conserver les éléments de comparaison #

Conservez ensemble l’ID du système source, l’ID du contenu, la langue cible et la révision cible. Pour vérifier le sens, ajoutez la révision source correspondante. Pour mesurer les modifications, conservez le brouillon à partir duquel le texte cible modifié a été produit.

Par exemple, dans votre propre fiche de suivi, la combinaison de delivery.promise, de la langue fr et de la révision 42 identifie une entrée précise du catalogue. La révision 43 peut modifier la promesse formulée.

Consignez l’origine de la traduction lorsque le workflow la précise : une personne, un modèle, un fournisseur de traduction automatique ou la réutilisation d’une mémoire de traduction. Si cette origine est inconnue, indiquez-la comme telle. La personne qui a approuvé une traduction chez le fournisseur n’est pas nécessairement la personne ou le modèle qui l’a rédigée.

Fournir les éléments de preuve adaptés à la question choisie #

Le critère détermine les éléments à collecter. Une vérification orthographique peut porter uniquement sur le texte cible. Une vérification du sens nécessite les textes source et cible correspondants, ainsi que du contexte pour lever les ambiguïtés. Une vérification terminologique nécessite le terme applicable et les limites de son usage. Une vérification des espaces réservés nécessite les règles auxquelles ils doivent se conformer, tandis que le calcul de la distance d’édition nécessite le brouillon et le texte cible réellement utilisés.

Si la révision source d’une traduction manque, laissez cette traduction parmi les cas non évalués pour la vérification du sens et récupérez la source avant de porter un jugement.

Vérifier un événement collecté #

  1. Configurez la mesure sélectionnée avant de générer une activité de test dans la source connectée.
  2. Retrouvez l’événement correspondant. Comparez sa langue, son texte, sa provenance et le brouillon disponible avec votre propre fiche de suivi.
  3. Ouvrez la réponse de la mesure et lisez le critère affiché à côté du texte. Vérifiez si la mesure a renvoyé une réponse, indiqué N/A ou échoué avant de se terminer.
  4. Conservez les identifiants de l’événement et de la mesure avec les révisions évaluées. Appliquez toute correction acceptée dans le système qui gère le texte.

Pour une évaluation locale, examinez plutôt le résultat enregistré en regard des fichiers d’entrée et de la configuration de l’évaluateur ; cette méthode ne crée pas d’événement Radar.

Pour un workflow récurrent, gardez une trace des éléments sélectionnés, collectés et mesurés. Le guide Mesurer les traductions depuis votre pipeline traite de la collecte et de la reprise, y compris des nouvelles tentatives et des changements de révision.