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.
Latest writing
- What makes code readable· 45 minutes ago · 49,209 reads
- When to optimize, when to wait· 10 hours ago
- Lessons from legacy codebases· 13 hours ago
Why defaults matter more
The tools we reach for shape our thinking. I've spent the last decade in terminals and shells, and it's changed how I approach problem-solving in subtle ways.
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 code. Updated monthly.
Elsewhere
Occasional notes on design topics. Archives here.