J’ai traduit en coréen la documentation des guides Rails les plus récents (8.1).
(rails.insomenia.com)À l’origine, j’étais un vieux de la vieille de Rails, mais après avoir navigué entre différentes stacks frontend,
je suis récemment revenu à Rails, et c’est vraiment un plaisir.
Rails 8 s’est énormément amélioré, et je regarde en rafale les récentes vidéos de DHH.
(On dirait que DHH est très actif en ce moment. Il suscite aussi pas mal de polémiques haha.)
Les guides officiels de Rails sont vraiment excellents,
mais comme je n’ai pas trouvé de traduction coréenne de la version 8 sortie cette année,
je l’ai traduite avec l’aide de l’IA.
J’ai utilisé l’API de Claude Sonnet 3.5,
et j’ai écrit un script Ruby qui traduit automatiquement tous les fichiers Markdown.
J’ai créé ce script de traduction Ruby à force d’allers-retours avec l’éditeur Windsurf.
C’est un script qui découpe un fichier Markdown en chunks de taille raisonnable (environ 50 lignes, sans couper les blocs de code),
les traduit, puis les recompose en un fichier Markdown en coréen.
Le coût des appels API a dépassé un peu les 30 000 wons, et j’ai utilisé 3,2 millions de tokens.
GPT-4o est bien meilleur que la traduction automatique d’autrefois, mais certaines parties restent peu naturelles.
Claude, en revanche, écrit clairement très bien. Dans les blocs de code, il ne traduit pas le code lui-même, seulement les commentaires.
Ce n’est sans doute pas au niveau d’un traducteur professionnel, mais je pense que le résultat est meilleur que si j’avais passé plusieurs mois à le faire moi-même.
J’ai aussi envisagé DeepL, mais même si c’est correct pour du texte brut,
il semble moins bien gérer le Markdown et les blocs de code.
J’espère que cela pourra être utile aux développeurs Rails !
6 commentaires
Merci pour cette excellente ressource. Même s’il y a par endroits des textes internationalisés dont la traduction n’aurait pas dû être fournie mais l’a été, la qualité de base est bonne. Au fait, avez-vous aussi ajusté séparément le prompt de traduction ?
Il faut sans doute revoir un peu la page i18n, merci pour le signalement ! Il n’y a pas vraiment de savoir-faire particulier dans le prompt ; j’ai simplement ajouté quelques indications supplémentaires sur les parties où le résultat sortait mal :)
Je suis curieux de savoir comment s'est passée votre expérience avec Windsurf.
Je l’utilise beaucoup ces derniers temps quand je développe
Avant, j’utilisais Cursor, et avant ça Copilot, et la vitesse de développement augmente clairement
Ça ne produit pas un code parfaitement correct à 100 %, mais ça écrit bien le code de patterns souvent utilisés
Et alors qu’il m’aurait fallu plusieurs heures pour écrire moi-même ce genre de code, l’IA le fait en quelques secondes
L’entreprise où j’étais entré en stage en alternance à l’université utilisait Rails, et comme il y avait trop peu de documentation en coréen, j’étais bien embêté... Le livre Rails que j’avais acheté à l’époque est même épuisé maintenant.
Bref, merci. Ça faisait longtemps, je vais aller y jeter un œil de nouveau !
Même si Rails est un peu de niche, il existe tout de même pas mal de ressources en anglais, alors qu'en coréen, il y en a vraiment très peu.
Comme l’IA traduit bien, s’il y a de la demande, j’envisage de créer des traductions de documents liés à Rails.