Field Notes

Essays on systems, infrastructure and doing careful work.

Why slow rollouts beat clever ones

March 14 · 9 min read

Every incident I have taken part in shared one property: something changed faster than anyone could observe it. The fix is rarely a better tool — it is a smaller step.

Notes on reading other people’s code

February 28 · 6 min read

Start with the data, not the entry point. Structures outlive functions, and they tell you what the author actually believed about the problem.

The quiet cost of a busy dashboard

February 9 · 11 min read

A panel that shows everything shows nothing. We removed two thirds of our charts and, for the first time in a year, noticed a regression on the day it shipped.

Backups you have never restored are folklore

January 22 · 7 min read

Two commands, once a month, on a spare machine. That is the whole discipline, and almost nobody keeps it.

On writing things down

January 5 · 5 min read

The document is not for the reader. It is for you, six months from now, when the context has quietly evaporated.