Writing
Long-form thinking on documentation systems.
Series and standalone essays on Docs-as-Code, information architecture, and the thinking behind documentation that scales.
Current Series
Systems Over Sentences
A technical writer's evolution — from producing content to designing documentation systems. Ten posts on how documentation actually works inside real product teams: the structure, workflows, tools, and thinking behind docs that scale.
All Posts
Systems Over Sentences · Part 1
From Writing to Documentation Systems
Most documentation doesn't fail because of bad writing. It fails because nobody designed how it should work. Here's what systems thinking actually looks like in practice.
Systems Over Sentences · Part 2
Your Documentation is a Bakery. Here's How to Build a Supermarket.
You can't control which page your reader lands on first. What you can control is whether every page has windows — connections that show readers where to go next.
Systems Over Sentences · Part 3
How Product Teams Actually Handle Documentation
Documentation doesn't break at writing or review. It breaks when no one clearly owns what happens next. And the most dangerous version of that problem isn't a large team — it's a solo writer with no external check.
Systems Over Sentences · Part 4
Writing for Developers vs Non-Technical Users
Systems Over Sentences · Part 5
Anatomy of Great Documentation
Systems Over Sentences · Part 6
Introduction to Structured Writing
Systems Over Sentences · Part 7
Docs-as-Code vs Traditional Documentation
Systems Over Sentences · Part 8
Documentation Workflow in a Real Team
Systems Over Sentences · Part 9
My Technical Writing Workflow
Systems Over Sentences · Part 10