What makes code readable
Naming is one of the hardest problems in software, yet we spend less time on it than we should. Let's talk about why it matters and how to get better at it.
Recent posts
- On writing code that lasts · 4 hours ago · 38,773 reads
- The ergonomics of error handling · 16 days ago
- Incremental adoption of types · 8 hours ago
Lessons from legacy codebases
Naming is one of the hardest problems in software, yet we spend less time on it than we should. Let's talk about why it matters and how to get better at it.
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
These are my notes on building reliable, readable, maintainable systems. Interested in clarity over cleverness.
Thoughts on writing. Updated sporadically.
Elsewhere
Occasional notes on design topics. Archives here.