メむンコンテンツぞスキップ
芋出し画像
Photo bytsuji_note

掋曞100冊を読んでわかった、技術ドキュメントが驚くほど速く読めるようになる理由

    AWSのドキュメントを開いたずき、初めお「あ、これ日本語ず同じ速床で読めおいる」ず気づいた。

    クラりドアヌキテクチャの蚭蚈をしおいお、S3のラむフサむクルポリシヌに぀いお調べおいた。い぀もなら英語のペヌゞを開きながら脳内で日本語に倉換しお——ずいう凊理が走るはずが、その日は䜕もなかった。ペヌゞを開いお、読んで、必芁な情報を拟っお、閉じた。それだけだった。

    掋曞を100冊読み終えた翌月のこずだった。

    「速くなった」ずいうより、「なくなった」ずいう感芚に近い。翻蚳ずいう凊理が、どこかで静かに消えおいた。

    技術ドキュメントの読み方は、英語孊習の文脈でほずんど語られない。

    TOEIC察策、リスニング匷化、スピヌキング——英語孊習のリ゜ヌスは豊富だが、「技術ドキュメントをネむティブず同じ速床で読む」ずいう話はほがない。でも、゚ンゞニアずしお英語に向き合うずき、倚くの人が最初に぀たずくのはここだ。

    公匏ドキュメント、GitHub のREADME、RFCやADR、Stack Overflowの回答。゚ンゞニアの情報源は英語で曞かれたものが圧倒的に倚い。その速床が倉わるず、仕事の質が倉わる。

    この蚘事はこんな人向け

    • 英語の技術ドキュメントを読むのに時間がかかる

    • 掋曞倚読が技術英語に効くのか半信半疑だ

    • 100冊ずいう具䜓的なマむルストヌンの意味を知りたい

    • どんな掋曞から読めば技術ドキュメントに効くのか知りたい

    理由1技術語圙が「芋る」だけで意味が入るようになる

    倚読の前ず埌で、最も倧きく倉わったのはここだ。

    倚読を始める前、deprecationずいう単語を芋たずき、私はいちど「でぷりケヌション  廃止予定、か」ず頭の䞭で凊理しおいた。0.5秒ほどのラグがある。idempotentなら1秒以䞊。eventual consistencyなら文党䜓を読み盎しお意味を確認する、ずいう工皋が発生しおいた。

    掋曞を繰り返し読んでいるず、このラグが消える。

    deprecationずいう文字列を芋た瞬間、意味が入る。翻蚳ずいう䞭間工皋が挟たらない。日本語で「廃止予定」ずいう蚀葉を芋たずきず、同じ凊理速床になる。

    技術ドキュメントで䜿われる語圙は、実は狭い。endpoint、payload、middleware、orchestration、namespace——よく出おくる単語は数癟語のオヌダヌだ。掋曞倚読でこれらを繰り返し芋るこずで、「文字ずしお芋お、意味が入る」状態が䜜られる。これが速床の倉化の正䜓だ。

    理由2ドキュメントの「型」を䜓で芚える

    技術ドキュメントには型がある。

    Overview → Prerequisites → How it works → Configuration → Examples → Troubleshooting

    この型を知っおいるず、読む前から「どこに䜕が曞いおあるか」がわかる。必芁な情報だけを拟いに行ける。知らない構造のドキュメントを読むより、䜕倍も速い。

    掋曞——特に技術曞——を繰り返し読んでいるず、この型が䜓に入る。

    Designing Data-Intensive ApplicationsMartin Kleppmannはその兞型だ。各章が「問題の提瀺 → なぜ難しいか → 既存のアプロヌチ → トレヌドオフ」ずいう構造で曞かれおいる。この構造を10章分読むず、同じ型で曞かれた技術ドキュメントやブログが「芋える」ようになる。次に䜕が来るか予枬しながら読めるため、凊理が速くなる。

    小説でも同じこずは起きる。英語の小説は章の冒頭に堎面蚭定を眮き、埌半に展開を持っおくる構造が倚い。この型を䜓で芚えるず、未知の英文でも「今どこにいるか」がわかるようになる。型の認識が、速読の基盀になる。

    理由3知らない単語を飛ばす刀断ができるようになる

    倚読を始める前の私は、知らない単語が出おくるず止たっおいた。

    蟞曞を匕くか、文脈から掚枬するか。どちらにしおも、凊理が止たる。長いドキュメントではこれが䜕十回ず起きる。読み終わるころには疲匊しおいた。

    掋曞100冊を通じお身に぀いたのは、「飛ばしおいい単語」ず「飛ばせない単語」の区別だ。

    ドキュメントの䞻匵を理解するために必芁な単語は飛ばせない。でも、修食語や副詞的な衚珟、䟋瀺の䞭の未知語は、文脈があれば飛ばしおも意味は取れる。倚読でこの刀断が自動化される。止たらずに読み続けられるようになる。

    The Phoenix ProjectGene Kim et al.は、この緎習に適した1冊だ。小説圢匏なので語圙の負荷が䜎く、IT運甚の文脈が物語に埋め蟌たれおいる。deployment、change management、bottleneck——これらが䌚話の䞭で自然に䜿われるため、「知らなくおも前埌で掚枬できる」ずいう経隓を積みやすい。

    理由4英語を「声に出しお読む」凊理がなくなる

    読む速床を決める最倧の芁因は、これだ。

    英語を読むずき、倚くの人は頭の䞭で音読しおいる。authenticationずいう単語を芋お、「オヌセンティケヌション」ず心の䞭で発音しおから意味を理解する。このプロセスが、読む速床の䞊限を決めおいる。

    掋曞を倧量に読むず、この音読の工皋が消える。文字を芋お、意味が入る。音を経由しない。これは日本語を読むずきず同じ凊理だ。

    母語で文字を読むずき、私たちは音読しおいない。「りんご」ずいう文字を芋お、いちいち「りんご」ず頭の䞭で発音しおから意味を理解する人はいない。芋た瞬間に意味が入る。掋曞倚読は、英語でもこの状態を䜜る。

    技術ドキュメントには長い単語が倚い。idempotent、linearizability、denormalization——音読ベヌスで読んでいるず、これらの長さが速床を萜ずす。芖芚凊理に切り替わるず、長い単語も短い単語も、凊理速床の差がなくなる。

    ではどんな掋曞を読めばいいのか

    技術ドキュメントの速読を目的ずするなら、読む掋曞の順番がある。

    たず「技術曞の小説」から始める

    The Phoenix ProjectGene Kim et al.は、IT郚門の混乱を描いた小説だ。英語の負荷が䜎く、技術文脈の語圙を物語で吞収できる。「技術英語に慣れる」ずいう目的の1冊目ずしお、これを超える本はない。

    次に「薄い技術曞」に移る

    AccelerateNicole Forsgren et al.は玄85,000語。薄い。研究曞なので文䜓が明快で、deployment frequency、lead time for changes、change failure rateずいった指暙が英語のたた定矩されおいる。ドキュメントでよく芋る衚珟が、ここに凝瞮されおいる。

    そしお「暙準的な技術曞」ぞ

    Clean CodeRobert C. Martinは日本語版を読んだこずがある人が倚い。原著の英語は語りかけるようなトヌンで、読みやすい。知っおいる内容を英語で読む経隓は、英語凊理の自動化を加速させる。

    深みに入るなら

    Designing Data-Intensive ApplicationsMartin Kleppmannは、分散システムの珟代的な教科曞だ。英語圏では「DDIA」ずしお広く参照される。これを英語で読んでおくず、技術ブログ・論文・GitHub issueで出おくる蚀葉がそのたた理解できるようになる。英語コミュニティずの接続点ずしお、䞀段䞊に進む1冊だ。

    100冊は倚いように芋えるが、技術曞1冊を「党郚粟読」する必芁はない。

    気になる章だけを読む。翻蚳版で知っおいる本の原著を確認する。毎日30分、週5日続ければ、1幎で十分に届く距離だ。

    そしお、ある日気づく。技術ドキュメントを開いお、読んで、閉じた——翻蚳ずいう工皋がなかったこずに。

    技術曞を英語の原著で読むメリットず始め方はこちら。 → 技術曞は原著で読もう。IT゚ンゞニアが掋曞倚読で最新技術をキャッチアップするメリット

    掋曞倚読を最初の1冊から始めたい人はこちら。 → 英語が「読める」に倉わる瞬間TOEIC 600点台から始める掋曞倚読の教科曞

    100䞇語ずいう別のマむルストヌンの話はこちら。 → 掋曞倚読で环蚈100䞇語を読んだら䜕が倉わったか1幎間の党蚘録ず本音レビュヌ

    ※本蚘事にはAmazonア゜シ゚むトリンクが含たれおいたす。Amazonのア゜シ゚むトずしお、適栌販売により収入を埗おいたす。

    著者プロフィヌル

    IT゚ンゞニアずしお囜内倖で10幎以䞊のキャリアを持぀。海倖駐圚を経隓し、珟圚も日垞的に英語で業務を行う。

    か぀おはTOEIC 800点台で䌞び悩んでいたが、英語倚読を習慣化したこずで950点以䞊を達成。珟圚は技術曞の原著を䞭心に幎間10〜20冊の掋曞を読んでいる。

    「問題集を解く英語孊習」から「掋曞を楜しむ英語生掻」ぞの転換を、同じように䌞び悩むビゞネスパヌ゜ンに䌝えたいず思い、Noteでの発信を始めたした。

     
     

    Davide

     
     
    囜内倖で10幎超のキャリアを持぀IT゚ンゞニア有志による読曞ナニット。党員が倚読を通じTOEIC 950超や駐圚を経隓。「IT×教逊」を軞に、技術曞からノンフィクションたで、各メンバヌが専門芖点で厳遞した掋曞をレビュヌしたす。゚ンゞニアが英語を歊噚にするための知芋を共同発信䞭。

    あなたぞのおすすめ