GitHubやStack Overflowの技術ドキュメントをバイリンガルで読む方法
プログラミングをしていると、英語の技術ドキュメントを避けて通れない場面が必ず来ます。GitHubのREADMEやIssue、Stack Overflowの回答、ライブラリの公式ドキュメント。日本語の情報だけで済むこともありますが、最新の情報や深い議論はほぼ英語で書かれています。
全文をGoogle翻訳にかける方法もありますが、技術文書にはコードブロック、コマンド例、変数名といった翻訳してほしくない要素が大量に含まれています。これらが巻き込まれると、翻訳結果はかえって読みにくくなります。
バイリンガル表示が技術文書に合う理由
BothLangのバイリンガルモードは、原文を残したまま翻訳を並べて表示します。これが技術文書では特に有効です。コードスニペットやコマンド例は英語のまま残り、その前後の説明文だけが日本語で補足されます。何を実行すべきかは原文で正確に読み取り、なぜそうするのかを翻訳で素早く理解する、という読み方が自然にできます。
GitHubのIssueやPull Requestのやり取りでは、参加者が前のコメントを踏まえて議論していることが多いです。ページ全体を一括翻訳すると文脈が飛ぶことがありますが、段落ごとに原文と訳を見比べられれば、議論の流れを追いやすくなります。
Stack Overflowでの使い方
Stack Overflowでは、質問と回答、そしてコメント欄を往復しながら情報を拾うことが多いでしょう。BothLangで読む場合のコツは、まず回答の説明文をバイリンガルで把握し、コード部分は原文のまま読むことです。回答者が「これはこの理由で動く」と書いている説明を日本語で理解し、実際のコード例は英語で正確にコピーする。この切り分けが効率を上げます。
ホバー翻訳も便利です。回答の大半は英語で追えるが、一段落だけ専門用語が密集して意味が取りにくい、というときに、その段落だけカーソルを合わせて訳を確認できます。
注意すべき点
技術文書の翻訳で最も気をつけるべきは、専門用語の訳し方です。翻訳エンジンが一般的な日本語に置き換えてしまい、正式な技術用語が消えてしまうことがあります。たとえば「deploy」が「展開する」と訳されたとき、文脈によっては正しいのですが、ドキュメント内で「デプロイ」と書かれている場合は原文のカタカナ表記のほうが適切です。
だからこそ、原文を隠さない読み方が重要です。翻訳はあくまで理解の補助として使い、実行するコマンドや設定値は必ず原文を参照する。この原則を守れば、技術ドキュメントを読むスピードは大幅に上がります。
英語の技術情報に日常的に触れていると、半年もすれば翻訳に頼る段落が減っていきます。最初は全文バイリンガルで読み、徐々にホバー翻訳だけで済むようになり、最終的には原文だけで追える部分が増えていく。BothLangはその過程を自分のペースで進めるためのツールです。