#documentation

Mark Dominus makes a simple but revealing observation: programmers who complain about documenting for coworkers are often perfectly willing to document for Claude. That sounds funny at first, but it points to a real shift in how developers are using LLMs as collaborators, and the article argues that those machine-facing notes can become genuinely useful project artifacts. The author recalls hearing a common complaint: people are angry that programmers will write detailed `CLAUDE.md` and `PROJECT

元記事はPDF形式の資料で、本文テキストはこの抽出だけでは内容を正確に復元しづらい そのため、ここでは「PDF資料として公開されているAI関連の文書」という事実を踏まえ、背景と読みどころを整理する AIの資料は、文章そのもの以上に「何を伝えようとしているか」を読むのが大事 技術資料は専門用語が多いが、実際には「何が変わるのか」「誰に影響するのか」をつかむのが本質 PDFの中身が機械的に圧縮されていて読みにくいときは、内容だけでなく形式そのものも情報になる 今回紹介するのは、Squarespace上で公開されている 「2026-Spring-AI.pdf」 というPDF資料です。 タイトルにある通り、AIに関する何らかの資料で、しかも「2026 Spring」という表現から、春時点の情報をまとめた文書だとわかります。 ただ、先に正直に言うと、この元データはテキスト抽出結果がほぼPDFの内部構造そのもので、本文の自然な文章が読み取れる状態ではありません。 つまり、この抽出情報だけでは「何が書いてあるか」を断定できない のです。ここはかなり重要で、無理に内容を想像してしまうと