The unreasonable effectiveness of a changelog
A file that takes ten minutes per release and answers most of the questions your users would otherwise ask you.
#documentation
6 pieces tagged documentation,
from July 5, 2025 to July 22, 2026.
The onboarding document that actually works
Most onboarding docs are written by people who already know. Here is what a new engineer needs on day one, in order.
Design docs people actually read
The average design doc is eleven pages and gets three comments, all on page one. Here's the format that works.
Documentation is a product and you should staff it like one
Every team says docs matter. Almost none of them assign an owner, a budget, or a metric.
AGENTS.md and the repository that explains itself
A convention nobody standardized became standard anyway. Here's what belongs in it and what doesn't.
Write the README first
The oldest trick in the book, still the best design tool available, and almost nobody does it.