Rails最新（8.1）ガイド文書を日本語に翻訳しました。
(rails.insomenia.com)もともと私はRailsの古参ユーザーだったのですが、フロントエンドスタックを行ったり来たりしたあと、
最近またRailsに戻ってきて、その良さを改めて実感しています。
Rails 8は本当にかなり良くなっていて、最近はDHHの動画もまとめて見ています。
（DHHは最近ものすごく活発ですね。議論の種もたくさん作っていますし（笑））
Railsの公式ガイドは本当によくできているのですが、
今年リリースされた8バージョンについての日本語訳ドキュメントが見当たらなかったので、
AIの助けを借りて翻訳してみました。
claude sonnet 3.5 apiを使い、
すべてのMarkdownファイルを自動翻訳するRubyスクリプトを書き、
翻訳用のRubyスクリプトはWindsurfエディタで何度かやり取りしながら作成しました。
1つのMarkdownファイルを適度なチャンク（50行前後、コードブロックを切らない条件）に
分けて翻訳したあと、日本語のMarkdownファイルとして結合するスクリプトです。
API呼び出しのコストは3万円を少し超える程度で、320万トークンを使いました。
gpt-4oは以前の機械翻訳よりはずっと良いものの不自然な部分があり、
claudeはやはり文章を書くのが上手いですね。コードブロック内ではコードは翻訳せずコメントだけ翻訳してくれて、
プロの翻訳者には及ばないとしても、私が何か月もかけて訳すよりは良い結果ではないかと思います。
deeplも検討しましたが、通常のテキストは問題ない一方で、
Markdownやコードブロックの扱いはあまりうまくないようです。
Rails開発者の皆さんの助けになればうれしいです！
6件のコメント
良い資料をありがとうございます。ところどころ翻訳されるべきではないテキストまで翻訳されている箇所はありますが、基本的なクオリティは高いですね。もしよければ、翻訳プロンプトも別途チューニングされたのでしょうか？
i18nのページは少し手を入れる必要がありそうですね。ご報告ありがとうございます！ プロンプトに特別なノウハウがあるわけではなく、結果がうまく出ない部分について追加のプロンプトを加えた程度です :）
Windsurfの体験はいかがでしたか？
最近、開発するときによく使っています
それ以前は cursor、その前は copilot を使っていましたが、開発速度は確実に速くなります
100%完璧なコードを作ってくれるわけではありませんが、よく使うパターンのコードはうまく書いてくれますし
そういうコードを私が直接書いたら何時間もかかったはずなのに、AIなら数秒で書いてくれるので
大学生のとき、産学連携インターンとして入った会社がRailsを使っていたのですが、日本語の資料があまりにも少なくて困ったことがあって……。そのとき購入したRailsの本も、今では絶版になっていたんですよね。
とにかくありがとうございます。久しぶりにちょっと覗いてみようと思います！
Rails は非主流ではありますが、それでも英語圏の資料はかなりある一方で、日本語のものはあまりにも少ないですよね。
AI がうまく翻訳してくれるので、需要があるなら Rails 関連ドキュメントの翻訳資料を作ってみようと思います。