April 2026
"Mind the gap"
Where do the docs end and the user's assumption begin? We're exploring what isn't written — the missing context, the assumed knowledge, and the gaps that cost users the most.
April 2026
Where do the docs end and the user's assumption begin? We're exploring what isn't written — the missing context, the assumed knowledge, and the gaps that cost users the most.
In this issue
A systematic approach to auditing gaps in inherited documentation, starting with the people closest to users rather than the content itself.
Why building a taxonomy of what you think you already know is one of the most effective ways to surface the gaps hiding inside it.
The tacit, unwritten judgment calls experienced writers rely on constantly, and why so much of that knowledge never makes it into any style guide.
A cautionary story about leaning on AI coding tools without understanding the fundamentals well enough to catch it when something goes wrong.
An argument that great documentation should aim to be invisible and precise, not "engaging" — and why the profession's drift toward personality over clarity is a mistake.