What makes code readable
Distributed systems fail in ways that are hard to predict. After years of debugging production incidents, certain patterns keep recurring. This post explores a few.
Latest writing
- Rethinking notification design· 8 days ago · 18,830 reads
- A philosophy of naming conventions· 7 hours ago
- On API design principles· 15 hours ago
Incremental adoption of types
Performance optimization is a tempting distraction. Every line of code that exists to optimize one specific case is a line that must be maintained and understood forever.
From the archive
Most codebases grow in directions their authors never anticipated. The pressure to optimize early is real, but constraints often produce more elegant solutions than freedom ever could.
About this site
A technical writer exploring systems thinking, code design, and the intersection of tools and thought.
Thoughts on craft. Updated monthly.
Elsewhere
Occasional thoughts on systems topics. Past essays here.