リーディングガイド
英語の技術文書を効率よく読むには?エンジニアのための実践法
公式ドキュメント、APIリファレンス、GitHubのIssue、RFCの多くは英語で書かれていて、翻訳版はたいてい遅れます。英語のまま読めることは、エンジニアにとって非常に実用的なスキルです。幸い、技術英語は文学の英語よりずっと規則的です。
技術文書をページ翻訳するとつまずく理由
- 用語が誤訳される:promise、thread、handle、token などは技術的に厳密な意味を持ちますが、機械翻訳は日常的な意味に訳しがちです。
- コードが壊れる:翻訳でコードブロックや関数名、設定キーが書き換わり、コピーしたサンプルが動かなくなることがあります。
- 検索語がわからなくなる:エラーメッセージ、API名、コミュニティの議論は英語です。訳語しか覚えていないと、問題が起きたときに何で検索すればいいかわかりません。
原文はそのままにして、本当につまずく一般的な単語だけ補助を受けるのがおすすめです。
ステップ1:文より先に構造を読む
技術文書には決まった型があります。まず見出し、目次、コード例、パラメータ表にざっと目を通し、そのページが何を解決するのかをつかんでから、関係する段落を精読しましょう。コード例とパラメータの説明だけで十分なことも少なくありません。
ステップ2:専門用語と一般語彙を分ける
つまずく単語はたいてい2種類に分かれます。
- 専門用語:idempotent、serialization、middleware など。英語の用語と技術的な意味をセットで覚え、無理に日本語訳を当てはめる必要はありません。
- 一般語彙:mitigate、leverage、arbitrary、subsequent など。あらゆるドキュメントに繰り返し出てくるので、一度覚えれば長く役立ちます。
読みにくさの本当の原因は後者であることが多く、文中ヒントですばやく補えるのもこちらです。
ステップ3:ドキュメントの頻出表現に慣れる
技術文書は決まった言い回しを繰り返し使います。慣れると読む速度がはっきり上がります。
- deprecated:非推奨。将来のバージョンで削除される可能性がある。
- under the hood:内部の実装では。
- out of the box:追加設定なしでそのまま使える。
- backward compatible:後方互換性がある。
- is not guaranteed:保証されない。その挙動に依存するのは危険。
- caveat:注意すべき制限や例外。
ステップ4:スマホで読むときもアプリを行き来しない
通勤中にiPhoneでドキュメントを読むのはよくあることですが、単語ごとに辞書アプリを行き来すると集中が途切れます。Safariで文中ヒントの拡張機能を使えば、難しい単語の真上に意味が表示され、コードや英語の用語はそのまま残ります。
WordHintはリーディングレベルより難しい単語だけにヒントを付けます。技術文書を読むときはレベルを少し高めにして、ヒントを本当に低頻度の単語に絞り、繰り返し出てくる一般的な単語は習得済みにすると、ページがどんどんすっきりします。
ステップ5:読むことを語彙につなげる
- ドキュメントで出会って、なかなか覚えられない一般的な単語を保存します。
- 数日おきに例文と読み上げで復習します。
- しばらく続けると、同じ種類のドキュメントで調べる単語が減っていくのを実感できます。
技術英語の語彙には限りがあります。数か月英語のドキュメントを読み続ければ、よくあるドキュメントの大半はスムーズに読めるようになるはずです。