Blog
Writing on diagrams
Practical notes on diagrams, docs, and developer ergonomics — published weekly.
OpinionFeatured
Why Your GitHub README Diagrams Look Amateur (and the 4 Fixes That Take 10 Minutes)
Most README diagrams suffer from the same four defaults. Here's how to fix all of them in under ten minutes — without redrawing anything.
May 19, 20262 min read