カールが選ぶ必読記事
Carl's Required Reading (carlkolon.com)
要約
エンジニアリングリーダーである著者が、チームの学習のために厳選したプログラミング関連の記事リストを公開しています。この記事リストは、良いソフトウェア開発のための重要な洞察や、著者の意見(ORMは悪、フロントエンドはシンプルにすべきなど)を補強する内容を含んでいます。プログラマー向けに技術的な内容が多く、特に重要な記事には著者のコメントが付記されています。
全文翻訳
Carl Kolon / Reading
Carl’s Required Reading
エンジニアリングリーダーとして、私はしばしばチームに記事を共有しており、それは冗談めかして「必読書」と呼んでいます。私の目標は、おそらく私たちと同じような課題に直面したことのある他のプログラマーたちの知恵を消化するのを助けることです。多くの要望に応え、興味のある他の皆さんのために、ここにリストを掲載します!
ほとんどの記事がこのリストにあるのは、私が良いソフトウェアを作成する方法について、重要または洞察に富むと考える点を指摘しているからです。ここにあるいくつかの点は、特定の事柄(例えば、ORMは悪であり、フロントエンドはシンプルであるべきだ)に関する私の意見を補強します。あなたはこの意見に同意しないかもしれません!しかし、たとえ反対の意見を感じたとしても、この記事から何か価値あるものを得られることを願っています。
これらの記事は技術的なものであり、プログラマーでない場合は興味を持てないでしょう。
このリストは少し圧倒されるかもしれませんが、お気に入りの記事には星印を付け、それぞれの記事がなぜ重要だと考えるかの簡単な要約も加えています。
コーディングプラクティス
⭐ The Grug Brained Developer
新米プログラマーにも経験豊富なプログラマーにも、もし1つの記事しか推奨できないとしたら、これを選びます。複雑さは悪です。
The Wrong Abstraction
コードの重複を見て、すぐにそれをどこかに集約して排除しようとする誘惑に駆られることがあります。このエッセイは、オブジェクト指向コードのファクタリングに関する2014年のトークを基にしており、それが適切でない場合について論じています。「単一の真実の情報源」をあらゆる場所に作成することに動機づけられたコーディングエージェントに対して、効果的に反論するためにこれを理解する必要があります。
Complexity Budget
プロジェクトが複雑になりすぎると、進捗が突然止まるように見えます。このエッセイは、この現象を理解し、可能な限り長くそれを遅らせる方法について論じています。
Locality of Behavior
プログラマー(およびコーディングエージェント)は、関心の分離(SoC)を達成したり、多数のヘルパー関数を作成してコードの再利用を排除しようとすることがよくあります。これと、コードの振る舞いをその単一のユニットだけを見たときに可能な限り明白にする原則である「Locality of Behavior」の間にはトレードオフがあります。
Yagni
将来のために投機的な機能をを作成することは、基本的に常に悪い考えです。
Parse, Don’t Validate
これを理解するには少し手間がかかりますが、基本的な考え方は、データの特定のプロパティを保証したいのであれば、そのプロパティをオブジェクトの型に直接エンコードすべきだということです。これにより、アサーションを壊すコードの変更は、実行時の値エラーではなく、コンパイル時に型エラーとしてスローされます。
プラットフォーム
⭐ Steve Yegge’s Google Platforms Rant
特にアクセシビリティやソフトウェア組織のセットアップに関して、非常に多くの良い内容が含まれています。すべての企業がBezosの命令を強制することを推奨するわけではありませんが、サービスの特徴をプログラム可能な方法で他のチームに公開できるかどうかを批判的に検討すべきです。読むだけでも楽しいです。
フロントエンド
⭐ HATEOAS
Webアプリケーションでは、状態はしばしばフロントエンドのマークアップとバックエンドの両方から分離されてエンコードおよび保存されます(例えば、ReactのuseStateなど)。多くの場合、状態とユーザーが許可されるアクションを、ユーザーに提供されるHTMLから直接取得し、導き出す方が理にかなっています。これはREST APIの本来の概念と密接に関連しています(ほとんどの現代の「REST」APIは、実際にはRESTの制約に従っていませんhttps://htmx.org/essays/how-did-rest-come-to-mean-the-opposite-of-rest/)。私も自身のサイトでHATEOASについて簡単に書いています。
Components and Hooks must be pure
バックエンドコードからReactへの移行時に人々が犯す最大の過ちは、フロントエンドを命令的に書こうとすることです。つまり、行ごとにコンピュータに何をすべきかを指示しようとします。これは通常、オブジェクト指向プログラミングで一般的な、状態と副作用の過剰な使用を伴います。代わりに、フロントエンドは宣言的に書かれるべきです。つまり、コンピュータに「何が欲しいか」を伝えるべきです。(現代の)Reactは、これをサポートするために関数型プログラミングスタイルを中心に設計されています。すべてのコンポーネントは関数であり、状態と副作用は、本当に必要な場合を除いて避けられます。その場合、フックが必要になります。Reactのドキュメント全体を読むことをお勧めしますが、1つに絞りたい場合はこれが最良です。
Understanding useMemo and useCallback
useMemoとuseCallbackは、Reactで最も誤用されているフック(おそらくuseEffectの次)であり、エージェントも人間もいたるところにそれらを投入したがります。この記事は、それらが実際に必要とされる場所についてのガイドです。
Hypermedia Systems—Components of a Hypermedia System
良いフロントエンドを書きたいのであれば、HTMLが基づいているモデルを理解することは非常に価値があります。これは素晴らしい本の素晴らしい章であり、ブラウザのデザインを最大限に活用するのに役立ちます。HTMLを「完全にJavaScriptベースのWebアプリケーションを構築するために、不本意ながら使用しなければならない、厄介でレガシーなマークアップ言語」と見なすのではなく、そのように活用できます。
データベース
⭐ The Vietnam of Computer Science
私は認定ORM(Object-Relational Mapper)嫌いです。新しいプロジェクトでは魅力的ですが、すぐにパフォーマンスの問題や混乱を引き起こし始めると考えています。例として、Postgresのスケーリングに関するOpenAIの記事をご覧ください。
これらの問題のあるクエリの多くは、オブジェクトリレーショナルマッピングフレームワーク(ORM)によって生成されるため、それらが生成するSQLを注意深くレビューし、期待どおりに動作することを確認することが重要です。
これは私が読んだ中で最高のORM反対論のエッセイであり、長いですが強く推奨します。
Wikipedia—The Object-Relational Impedence Mismatch
私の反ORM運動のための追加の弾薬です。これはより技術的ですが、より簡潔なので、箇条書きだけを探しているならこれを読むと良いでしょう。
Introduction to PostGIS—Geography
PostGIS(および地理空間データベース)には、慣れるのに少し時間がかかります。地図ベースのデータビジュアライザーを構築する際に、扱っている新しいデータ型を理解することは良いことです。PostGISは優れたデータベースであり、その基本的なデータ型はgeographyです1。
Postgres Docs Chapter 14—Performance Tips
データベースの速度が低下し始めたときに「読んでおくべき」記事として最適です。EXPLAINとEXPLAIN ANALYZEの使い方を知ることは、デバッガの使い方を知ることと同等だと私は考えています。
Paging Through Results
ほとんどの人は、ページネーションシステムを構築する際にLIMITとOFFSETを使用します。大量のデータをページングする場合、これらは遅くなります(特に高番号のページを読み込む場合)。これは、この問題に対処するためのいくつかの他のオプションの優れた概要です。私も自身のサイトでこれについて話しています。
非同期プログラミング
A Conceptual Overview of asyncio
多くの人は、非同期プログラミングにいきなり放り込まれ、何が起こっているのかを本当には理解せず、進みながら学んでいきます。これはしばしば、非同期関数内でブロッキング呼び出しを行うなど、恥ずかしいほど基本的なasyncioのミスにつながります。これはドキュメントからの良い記事であり、asyncioが内部で何をしているのかをより明確にし、それによってそれを最良の方法で使用する方法を教えてくれるはずです。
What Color is your Function?
Bob Nystromは私が好きなプログラミング作家の一人です。これは、非同期プログラミングシステムがしばしば根本的な欠陥を持っている例です。できることはあまりありません(別の言語を使用する以外は)が、これにより、遭遇する非同期プログラミングの制限の一部は、スキルの問題ではなく、根本的なものであることを少なくとも学ぶことができます。
エンコーディング
The Absolute Minimum Every Software Developer Absolutely, Positively Must Know About Unicode and Character Sets (No Excuses!)
キャリアの早い段階でこれを読んでいれば、インターネットから収集したデータを不正確に解析するのに数百時間を節約できたでしょう。
書籍
これらの書籍は、プログラミング、デザイン、ソフトウェアプロジェクトの管理に対する私の考え方を形作ってきました。
The Design of Everyday Things (Amazon)
多くの人は「デザイン」とは物事を美しく見せることだと考えているようです。実際には、デザインとはユーザーのニーズを予測し、製品がそれらのニーズを可能な限り満たすようにすることです。多くの場合、この第二の意味でのデザインは第一の意味と相反しますが、そのような場合は第二を選ぶべきです。本書の「ノーマン・ドア」の初期の例は、著者がどのように機能するかを理解できないにもかかわらず、「おそらくデザイン賞を受賞した」という皮肉な観察とともに、素晴らしい例となっています。
Designing Data-Intensive Applications (O’Reilly) (Amazon)
この本を気に入っているのはミームのようなものですが、実際には本当に素晴らしいです。また、オーディオブックでもうまく機能する数少ないプログラミング本の1つでもあります。私のお気に入りの章は7(トランザクション)と10(バッチ処理)です。意見が分かれるかもしれませんが、これはデータベースの素晴らしい入門書でもあり、データシステムで実際に何を最適化したいのかを深く考えさせられます(たとえ何十億ものユーザーにサービスを提供していないとしても)。
Crafting Interpreters (free online)
これは、まずJavaでシンプルに、次にCでパフォーマンスを重視してインタプリタを構築する方法を教えてくれる、素晴らしく、励みになり、楽しい本です。Javaコードを読みながら直接書き込むこともできますが、別の言語でインタプリタを実装してみる方がさらに良いと思います。そうすれば、より多くの脳を使うことになります。私はRustを使用しました。
Category Theory for Programmers (free online) (order hardcover)
この本は少しハードコアですが、私が今まで見た中で最高の圏論入門です(ただし、厳密さを重視するファンであれば、自分で正式な定義をいくつか検索したいかもしれません)。良い関数型コードを書きたいと思いつつ、「ファンクター」や「モナド」のような言葉を使って同僚を感心させたいなら、これを読んでください。
The Mythical Man-Month (Amazon)
この本は1975年(!!)に出版され、最も最近では1995年に改訂されましたが、依然として信じられないほど関連性があります。実際、プログラマーがAIツールを装備するにつれて、一部の章(第4章、システムデザインにおける貴族政治と民主主義など)は1995年よりも現在の方が適用可能であるように思われます。プログラミングプロジェクトを管理して成功させたいなら、これを読んでください。
注釈
- これは実際には正しくありません。Hacker Newsでseabreが指摘したようにhttps://news.ycombinator.com/item?id=49217184。PostGISの基本的なデータ型は
geometryであり、こちらで読むことができます。それでもgeographyについて学ぶことは有益であり、入門ページはもう少しアクセスしやすいです。↩