

Blog
Concevoir une documentation pour les humains
Pourquoi le design compte toujours à l'ère de l'IA, et nos principes de conception documentaire pour alléger la charge mentale.

Kevin is an infra and product engineer at General Translation, where he works on all design, brand, and product surfaces. He enjoys building with care, with attention to detail and craft.
Check out his work at kevinliu.studio.


Pourquoi le design compte toujours à l'ère de l'IA, et nos principes de conception documentaire pour alléger la charge mentale.
6 sur 16 affichés
Locadex est l’agent IA de General Translation qui internationalise votre code et traduit votre contenu dans votre dépôt GitHub. Ses automatisations s’exécutent à l’ouverture d’une pull request, lors du push d’un commit ou lorsque vous les lancez vous-même, et chaque modification arrive sous forme de pull request.
Traduire une application Vue consiste à faire passer chaque chaîne de caractères des modèles par une recherche dans la langue active, puis à la traduire dans chaque langue cible. Le plugin gt-vue de General Translation traduit le contenu encapsulé dans le composant <T>, et npx gt translate génère un catalogue par langue cible.
Marquez le texte dans vos composants, générez un fichier de traduction pour chaque langue, ajoutez des polyfills Intl et chargez le fichier correspondant à la langue de l’appareil. Avec gt-react-native, la bibliothèque expérimentale de General Translation, vous encapsulez le texte dans <T>, un plugin Babel ajoute les polyfills et npx gt translate génère les fichiers.
Traduire une application React consiste à internationaliser ses composants pour qu’ils s’affichent dans la langue de l’utilisateur, puis à traduire chaque chaîne de caractères dans chacune des langues prises en charge. gt-react de General Translation traduit le JSX sur place dans le composant <T>, et npx gt translate génère un fichier par langue.
Détectez la langue de chaque requête, généralement à partir de son en-tête Accept-Language, et renvoyez toutes les chaînes dans cette langue. Le package gt-node de General Translation lie le paramètre régional à chaque requête avec withGT et traduit les chaînes avec getGT, à partir des traductions générées par npx gt translate --publish avant le déploiement.
Rédigez une copie traduite de chaque page dans un dossier par langue, puis ajoutez chaque langue à la navigation de docs.json. Locadex, l’agent IA de General Translation, ouvre une pull request qui ajoute les pages traduites et la navigation propre à chaque langue, puis traduit les modifications ultérieures.