topic
featured · 7m read on observability
Featured Mon · 14 Apr '26

Observability without dashboards.

Most teams treat dashboards as the destination — they're not. Dashboards are the airport: a place you pass through on the way to a real answer. A note on logs, traces, and the discipline of asking better questions.

essay observability backend tooling
04 / 26 · 7 min read read essay →
04 Archive

Older notes, still kept.

Tue · 03 Mar '26 5m

Error paths are an interface

The way your code fails is part of how others read it. A short argument for treating error paths with the same care as the happy ones.

notes go api-design
Sun · 18 Feb '26 8m

The weight of a good name

On naming variables, files, and projects — and why the quiet satisfaction of a perfectly chosen identifier is one of the strange joys of this work.

essay craft writing
Wed · 22 Jan '26 11m

A migration that aged me five years

An honest postmortem of the 36-hour database migration — what went wrong, what I'd do differently, and why "rolling back" is not always an option.

postmortem postgres
Fri · 12 Dec '25 4m

Code that grows old gracefully

Not all code is meant to be rewritten. Some is meant to age. A small list of things I've found shared by codebases that did.

notes craft
Sat · 09 Nov '25 6m

The politics of an abstraction

Every abstraction has a constituency. A meditation on the invisible alliances that form around interfaces — and what happens when they break.

essay architecture
Tue · 14 Oct '25 3m

Three things I keep telling juniors

The same three things, every six months. They have not yet stopped being true.

notes mentorship
Sun · 22 Sep '25 9m

In defence of small functions

Yes, the pendulum has swung. No, the answer is not to undo small functions wholesale. A careful look at when to inline, and when to leave well enough alone.

essay refactoring
Thu · 04 Aug '25 2m

A short note on README files

They are the first thing every reader sees. We treat them like they're the last thing we wrote.

notes documentation

end of feed · 12 of 12 entries

Subscribe via RSS