Articles
Documentation
AI-Native Workflows
Using AI to speed up design documentation
AI writes usable component docs in minutes. It also writes confident, plausible-sounding garbage if you give it the wrong input.
Design Systems
Writing component specifications that engineers trust
Engineers don't ignore specs out of disrespect for design. They ignore them because the specs are wrong in specific, predictable ways.
Design Systems
The design system documentation nobody reads (and how to fix it)
Most doc sites get traffic on component pages and almost nothing else. The problem isn't the writing. It's what the other pages are trying to do.
Design Systems
How to write component documentation that people actually read
Most documentation is written to be comprehensive. Good documentation is written to be used at the moment of need. The difference is everything.