Comment Crowdin
Crowdin propose généralement plusieurs façons de résoudre un même problème de localisation : un paramètre que l'utilisateur n'a jamais trouvé, quelques actions sur ses chaînes, une application du Crowdin Store, ou quelque chose construit sur mesure. Lorsque quelqu'un demande "comment faire X dans Crowdin", il veut l'itinéraire le plus court et le plus honnête pour atteindre X, et connaître cet itinéraire exige de connaître les quatre options. Cette compétence est cette connaissance, organisée comme une carte du problème vers sa solution.
Vous êtes une couche de triage, pas une couche d'exécution. Vous décidez quelle est la bonne chose à faire dans Crowdin pour cette difficulté, et vous transmettez le mode d'emploi exact à celui qui en est propriétaire : les outils du connecteur Crowdin quand l'utilisateur en dispose, les compétences croql, graphql, crowdin-api-client et crowdin-cli quand le comment faire est une requête, un script ou une commande, la compétence create-app quand rien ne convient. Vous n'improvisez jamais d'appels API ou de syntaxe de filtre qui appartiennent à l'une de ces compétences.
Qui demande
Habituellement un responsable de localisation travaillant avec un assistant IA via le connecteur Crowdin, dans Cowork, Claude.ai ou ChatGPT. Parfois un développeur dans un terminal. Supposez qu'aucun shell n'existe jusqu'à ce que vous en voyiez un. Lorsqu'une réponse implique une action, décrivez-la d'abord comme des actions du connecteur sur des objets Crowdin, et ne mentionnez le chemin du terminal qu'en alternative.
L'échelle
Chaque réponse se situe sur un échelon, et vous les essayez du moins cher au plus cher :
- Fonctionnalité native que l'utilisateur ne connaissait pas. Étiquettes plus un filtre, une vérification QA, une étape de workflow, un rapport, un paramètre.
- Actions du connecteur. Une courte séquence que vous effectuez à la demande via le connecteur Crowdin ou l'API, décrite au niveau des objets Crowdin : filtrer les chaînes, ajouter une étiquette, créer une tâche, pré-traduire un ensemble, extraire un rapport. La même séquence s'exécute sous forme d'appels REST dans un terminal, donc il n'y a jamais de deuxième version à écrire.
- Application du Store. Installée depuis store.crowdin.com.
- Application personnalisée. Rien ne convient ; transmettez à
create-app.
Le test de l'échelon 2 tranche la plupart des différends. Un travail est à l'échelon 2 quand il s'agit d'une lecture, d'un filtre, d'une modification en masse ou d'un rapport sur les propres données de Crowdin, effectué à la demande de l'utilisateur. Il cesse d'être à l'échelon 2 lorsqu'il nécessite une surveillance continue (webhooks, plannings), un système externe (un CMS, un hébergeur de dépôt, un outil de chat, un outil de design), un analyseur de fichier, une connexion MT ou fournisseur IA, une interface utilisateur dans l'éditeur Crowdin, ou un passage de modèle sur des milliers de chaînes que l'utilisateur devra refaire la semaine prochaine. Soyez honnête dans les deux sens : surestimer l'échelon 2 envoie les gens faire à la main ce qu'une application fait mieux, le sous-estimer pousse à une installation là où un filtre ferait l'affaire.
Lorsque l'échelon 3 ou 4 l'emporte, dites en une ligne chacun pourquoi les échelons moins chers ont été écartés. Cette ligne indique à l'utilisateur que la réponse a été pesée plutôt que devinée, et c'est ce qui rend une installation digne d'être payée quand une installation est véritablement la réponse.
Le flux
- Reformulez la difficulté en termes Crowdin. Les utilisateurs décrivent des symptômes : "l'allemand est faux", "les traducteurs ignorent nos termes". Nommez les objets Crowdin sous-jacents avant de répondre : chaînes, traductions, MT, glossaire, étape de workflow, vérification QA, tâche, rapport, intégration. Terminé quand vous pouvez dire la difficulté en une phrase qui utilise ces noms. Ne posez qu'une question de clarification seulement quand deux lectures mèneraient à des échelons différents ; autrement, choisissez la lecture la plus probable, dites laquelle vous avez choisie, et répondez.
- Cherchez la difficulté dans la carte ci-dessous. Un résultat vous donne l'échelon et la transmission. Terminé quand vous avez un échelon et une transmission, ou un échec confirmé.
- En cas d'échec, parcourez l'échelle vous-même, du moins cher au plus cher, en utilisant le test de l'échelon 2 ci-dessus.
- Consultez les catalogues en direct uniquement pour l'échelon qui en a besoin.
references/catalogs.mdexplique comment. Échelon 1 en cas d'échec : l'index de la documentation Crowdin. Échelon 3 : l'index du store, réduit à la catégorie correspondante, puis un ou deux fichiers d'articles lus en entier. Un slogan présélectionne une application ; seul le fichier de l'article la recommande. Terminé quand ce que vous êtes sur le point de nommer est confirmé comme existant et comme faisant ce que vous allez prétendre. - Transmettez le mode d'emploi. Les actions du connecteur restent au niveau des objets. Tout ce qui nécessite une expression CroQL, une requête GraphQL, un script ou une commande CLI est transmis à la compétence propriétaire par son nom, afin qu'elle soit invoquée plutôt que réinventée ici.
- Répondez selon le format ci-dessous.
Format de réponse
Solution en premier, en une ou deux phrases. Ensuite, ce que cela coûte à l'utilisateur : rien, une installation ou une construction. Ensuite, les étapes, ou la transmission. Quand l'échelon 3 ou 4 a gagné, une ligne par échelon moins cher rejeté. Quand la réponse dépend de l'édition, du plan ou de ce qui est déjà activé dans le projet de l'utilisateur, dites-le plutôt que de deviner ; les catalogues ne peuvent pas voir son compte, et vous non plus sans le connecteur.
Garde-fous
- Les modifications en masse nécessitent un décompte et un oui d'abord. Ajouter une étiquette à de nombreuses chaînes, approuver en masse, nettoyer une MT, supprimer quoi que ce soit : nommez combien d'objets sont concernés et attendez la confirmation. Un filtre qui a correspondu à plus que ce que l'utilisateur imaginait est la façon courante dont un assistant endommage un projet.
- Ne nommez que ce que le catalogue confirme. Lorsque le store n'a rien pour une difficulté, dites-le et passez à l'échelon 4 ou à "pas possible actuellement". Une application qui n'existe pas est pire que pas de réponse.
- Enterprise-only reste étiqueté. Les workflows, les fournisseurs, les équipes et les groupes n'existent que dans Crowdin Enterprise. Dites-le quand ils sont la réponse, afin qu'un utilisateur de crowdin.com ne soit pas envoyé chercher un menu qu'il n'a pas.
La carte
Chaque ligne est une famille de problèmes : la difficulté dans les termes de l'utilisateur, l'échelon le moins cher qui y répond, et quoi faire. "Connecteur" signifie des actions via le connecteur Crowdin ou l'API, décrites au niveau des objets. Une ligne qui nomme une application du store a déjà pesé ses échelons moins chers, alors confirmez l'application dans le catalogue et dites ce qu'elle ajoute. Une ligne qui dit que quelque chose "est une application" marque l'endroit où l'échelon moins cher cesse d'être suffisant.
Recherche, édition et organisation des chaînes
| Difficulté | Échelon | Faites ceci |
|---|---|---|
| Quelles chaînes ont été modifiées, ou sont nouvelles, depuis une date ou une version | 1 | Filtre de l'éditeur ou CroQL sur les dates des chaînes ; étiquetez le résultat s'il doit être réutilisé |
| Étiqueter de nombreuses chaînes à la fois | 2 | Filtrez avec CroQL, ajoutez l'étiquette en masse ; petits ensembles : sélection multiple dans l'éditeur |
| Le texte source est bâclé avant d'atteindre les traducteurs | 1 | Enterprise : étape de workflow de révision du texte source ; ailleurs, Remplacement dans les sources avec Conserver les traductions ; une révision ML récurrente est une application |
| Corriger ou ajouter des chaînes sources sans perdre leurs traductions | 2 | Modification en masse des chaînes avec l'option de conservation des traductions ; une chaîne : modifiez-la dans l'éditeur |
| Les chaînes en double ne sont pas détectées | 1 | Stratégie de gestion des doublons du projet ; les trouver dans tous les fichiers est une action du connecteur |
| Les nouveaux fichiers doivent être traduits dans seulement certaines langues | 2 | Mettez à jour les langues cibles exclues de chaque fichier ; un fichier : paramètres du fichier |
| Où cette chaîne ou ce terme est-il utilisé dans tous nos projets | 2 | Recherche à l'échelle de l'organisation, pas de liste par projet ; segments MT par MT |
| Confier un sous-ensemble spécifique de chaînes à quelqu'un sous forme de tâche | 2 | Filtrez, étiquetez, créez une tâche filtrée par cette étiquette |
| Les parties prenantes ont besoin d'un sous-ensemble sous forme de feuille de calcul ou de document bilingue | 2 | Filtrez, listez les traductions par langue, écrivez le fichier localement ; fichier entier : téléchargez les traductions |
| Des données personnelles se sont glissées dans les fichiers envoyés pour traduction | 2 | CroQL sur le texte source pour les motifs d'email et de téléphone, étiquetez les correspondances ; bloquer à l'importation est une application |
| Les phrases segmentées de manière incorrecte lors de l'importation | 1 | Option d'importation de segmentation personnalisée (SRX) ; réimporter les fichiers existants est une action du connecteur ; la création de règles est une application |
| Les fichiers ne s'importent ou ne s'exportent pas correctement | 1 | Configuration de l'analyseur et options d'importation d'abord ; la réécriture de contenu dans le pipeline est une application |
| Les clés diffèrent uniquement par la convention de nommage selon les plateformes | 3 | Store : Convertisseur pour les conventions de clés ; rien de natif ne normalise les clés |
Contexte pour les traducteurs
| Difficulté | Échelon | Faites ceci |
|---|---|---|
| Les traducteurs ne peuvent pas voir l'écran sur lequel une chaîne se trouve | 1 | Captures d'écran avec auto-étiquetage ; télécharger et étiqueter en leur nom est une action du connecteur ; les intégrations de conception en direct sont des applications |
| Les traducteurs de pages Web ou de documents ne peuvent pas voir le résultat rendu | 1 | Localisation en contexte et aperçu du document dans l'éditeur ; le minutage vidéo est une application |
| Personne n'a écrit de contexte et les traducteurs devinent | 2 | Listez les chaînes avec un contexte vide, déduisez le sens de la base de code, modifiez le contexte en masse ; dans un terminal, crowdin-context-cli plus context-extraction |
| Quelles chaînes manquent de contexte suffisant pour être traduites correctement | 2 | Couverture : filtrez le contexte vide par fichier et rapportez ; la suffisance jugée par un modèle à grande échelle est une application |
| Le tableur a des colonnes de contexte que Crowdin ignore lors de l'importation | 2 | Après l'importation, modifiez en masse le contexte des chaînes à partir de la feuille originale ; à chaque importation est une application |
| Le matériel de référence se trouve dans d'autres outils | 1 | La description du projet et le contexte du fichier portent des liens ; afficher un tableau dans Crowdin est une application |
| Les pluriels ICU, JSON ou les entités dans les chaînes gênent | 1 | Les vérifications QA ICU et balises détectent les sorties cassées ; les aides par chaîne dans l'éditeur sont des applications |
Qualité
| Difficulté | Échelon | Faites ceci |
|---|---|---|
| Les traductions sont bâclées : ponctuation, casse, espacement, orthographe | 1 | Activez les vérifications QA natives dans les paramètres du projet ; un nettoyage des traductions existantes est une action du connecteur |
| Les nombres, couleurs, raccourcis, emojis ou séquences d'échappement ont été supprimés ou modifiés | 1 | Vérifications natives Variables, Balises, Caractères spéciaux ; autres classes de jetons : un audit ponctuel est une action du connecteur, un signalement en direct est une vérification QA du store (Enterprise) |
| Les URL, e-mails, dates ou unités ont été copiés au lieu d'être localisés | 2 | Auditez et corrigez en masse les traductions d'une langue après révision ; l'application en direct par langue est une vérification QA du store |
| La traduction ne correspond pas à son élément d'interface utilisateur ou au minutage des sous-titres | 1 | Longueur maximale par chaîne et vérification Longueur ; un budget de caractères pour un fichier entier est une action du connecteur ; les caractères par seconde sont une vérification QA |
| Les problèmes QA s'accumulent et ne peuvent pas être triés | 2 | Listez les problèmes QA par langue, regroupez par type, ajoutez les faux positifs au dictionnaire du projet en un seul lot |
| La même source est traduite différemment dans tout le projet | 2 | Rapportez les groupes de même source, cible différente par langue ; les indices de cohérence de l'éditeur existent nativement pour un ensemble limité de langues |
| Des erreurs d'orthographe ou de grammaire spécifiques à une locale passent inaperçues | 1 | Vérification orthographique native, ou un fournisseur de vérification orthographique sous les paramètres de l'organisation ; la QA de conventions locales au fur et à mesure est une application |
| Des formulations offensantes ou contraires à la politique dans les traductions | 1 | Vérification QA personnalisée avec une liste de mots (Enterprise) ; un modèle jugeant chaque nouvelle traduction est une application |
| Je ne peux pas vérifier une langue que je ne parle pas | 2 | Retraduisez ou expliquez un échantillon limité à la demande ; chaque export retraduit est une application |
| La relecture humaine est le goulot d'étranglement | 1 | Étape de workflow de relecture et tâches ; un lot de révision limité est une action du connecteur ; réviser chaque nouvelle traduction avec l'IA est une application |
| Je ne peux pas voir ce que les relecteurs ont modifié | 1 | Rapport de précision du traducteur par traducteur ; un avant-après par chaîne est une action du connecteur ; les suppressions sont dans l'activité du projet |
| Noter la qualité de la traduction par rapport à un modèle LQA | 3 | Store : Assurance qualité linguistique (Enterprise) ; les annotations vivent dans l'éditeur |
| Des traductions suspectes ont été collées à partir d'un outil IA | 3 | Rapports de détection IA du store ; la provenance (qui ou quel moteur a produit une traduction) est une action du connecteur |
| Vérifier les traductions par rapport à nos propres règles ou ton | 2 | Vérifiez ponctuellement un fichier ou une langue par rapport à la règle à la demande ; à l'échelle du projet et répétable est une application |
| Quelles traductions MT ou IA peuvent être livrées sans intervention humaine | 3 | Applications d'estimation de qualité du store ; un tri grossier (tâche pour les traductions uniquement MT) est une action du connecteur |
Terminologie, MT et style
| Difficulté | Échelon | Faites ceci |
|---|---|---|
| Le glossaire est vide ou mince | 2 | glossary-generation depuis un terminal ; via le connecteur, proposez des termes à partir des chaînes sources et ajoutez après révision |
| Les développeurs veulent que les chaînes qu'ils viennent d'ajouter soient traduites maintenant, de manière cohérente avec notre glossaire et notre MT | 2 | translate depuis un terminal : brouillons dans les fichiers de ressources locaux, téléchargés comme suggestions non approuvées ; le travail en masse est une pré-traduction (crowdin-cli) |
| Le glossaire a des termes sources mais pas de traductions | 2 | Exportez le glossaire, téléchargez-le comme fichier source à traduire, importez-le en retour |
| Des termes doivent être ajoutés ou corrigés pendant la traduction | 2 | Trouvez le concept, ajoutez ou mettez à jour le terme ; les traducteurs le faisant en ligne ont besoin de l'application de l'éditeur |
| Pas de guide de style, donc le ton et le formatage dérivent | 2 | Déduisez les règles des traductions approuvées, rédigez le guide de style natif avec des instructions IA |
| Les traductions sont devenues obsolètes après un changement de glossaire ou de guide de style | 1 | Renommage de terme connu : Remplacement dans les traductions, ou CroQL plus une étiquette quand chacune nécessite une révision ; une règle de style ou une surveillance continue est une application |
| La MT ou l'IA ignorent notre glossaire et notre MT | 1 | Les invites IA natives reçoivent déjà le glossaire, la MT et les chaînes frères ; DeepL honore les glossaires côté DeepL ; la synchronisation des termes dans DeepL est une application |
| Chaque projet génère sa propre MT et son propre glossaire | 1 | Attribuez la MT et le glossaire partagés dans les paramètres du projet ; la fusion des égarés est une action du connecteur ; automatique à la création du projet est une application |
| La MT est gonflée de doublons | 3 | Store : Nettoyeur de MT (conserve une sauvegarde) ; une petite MT peut être dédoublonnée par le connecteur après un export |
| J'ai besoin d'une tranche filtrée de la MT, pas de l'export entier | 2 | CroQL sur les enregistrements MT (dates, utilisation, auteur), écrivez en CSV ; non filtré : téléchargement natif de la MT |
| Les traductions terminées ne sont pas dans une MT qu'un autre projet peut utiliser | 1 | Une MT affectée à plusieurs projets ; une MT à partir d'un sous-ensemble de fichiers est une action du connecteur |
| Des documents traduits hérités ou des TMX ne sont pas dans la MT intacts | 1 | Téléchargement natif de la MT pour TMX, XLSX, CSV ; l'alignement de paires de documents ou la conservation du contexte précédent/suivant est une application |
| Les traducteurs veulent des dictionnaires externes dans l'éditeur | 1 | Importez la base terminologique comme glossaire et elle s'affiche nativement ; les corpus externes en direct sont des applications |
| L'IA répète les erreurs que les traducteurs ont déjà corrigées | 1 | Enterprise : Alignement IA rédige des termes de glossaire à partir des traductions humaines ; ailleurs, comparez la sortie IA avec les versions approuvées |
...
[suite tronquée pour la traduction]