Engineering writing
5 posts that follow one problem from symptom to cause.
Bugs and surprises from real engineering work, written up with the commands and numbers that settled each one. The stories live on Medium; this is the index, since 30 Sep 2026.
5
posts on Medium
20
topics covered
5
subject areas
15 Nov 2026
latest post
All posts
newest first
Frontend
size-4 Is Not 16 Pixels
The compiled CSS was byte-identical at every spacing value. The icon still rendered 20px instead of 16px.
Git
The Line git blame Can't See
git blame tells you who touched a line last. For a line that's already been deleted, it has no answer at all.
Rails
The Fix That Only Reached Half the Server
We fixed a config file, restarted the app and watched one feature recover. The other kept failing for a day and a half.
DevOps
The Restart Command That Only Worked When a Human Typed It
A supervisor noticed the crash, ran the restart and failed every time. The command was right. The shell it ran in was not.
Distributed Systems
The Water That Flowed Backwards
One line of Go made our water meters report negative consumption. The fix we added afterwards was the same bug in disguise.