Write Documentation Humans Want to Read, Not AI Wants to Generate
AI made documentation effortless to produce, but the cost of reading it just moved from the writer to the reader. A case for optimizing docs for readers, not writers.
Writing
Everything I’ve published, grouped by topic. Newest first within each.
AI & Engineering
1 articleEngineering Craft
1 articleAre you a Software Developer or a Software Engineer?
One writes code; the other solves problems by thinking flexibly across languages, domains, and uncertainty — and why that distinction matters more in the age of AI.
Reflections
1 articleAre We Building a Good Life, or Just a Successful One?
The tech industry gives you a comfortable life and a quiet, constant sense of falling behind. On why stepping outside the noise — no signal, existential books, distance — helps you see it more clearly.