
Runbooks the On-Call Engineer Will Actually Open at 3am
Most runbooks are written for someone calm at a desk, not someone half-awake under pressure. What makes an on-call runbook get opened and used.
Tag archive

Most runbooks are written for someone calm at a desk, not someone half-awake under pressure. What makes an on-call runbook get opened and used.
A stale runbook doesn't just fail you once. It teaches you to distrust every doc you have, including the parts that were still right.
It's 3:07 AM. PagerDuty fires. The on-call engineer opens the wiki. The runbook was last edited 14...
A good runbook lets any on-call engineer resolve an incident at 3am without paging the one person who knows the system. Here is how to write runbooks

The Folder Full of Stale Runbooks Every engineering org has a Confluence folder of...

Your runbooks are out of date. I don't know your team, but I'd bet money on it. Most teams write...

The Runbook Nobody Reads We had runbooks. Beautiful, detailed, Google-Docs runbooks. 47...
An agent has no memory of its dead ends. Every clever fix that failed has to be written down, or some fresh session will try it again. So my runbooks

The Folder Full of Stale Runbooks Every engineering org has a Confluence folder of...

The Runbook Nobody Reads We had runbooks. Beautiful, detailed, Google-Docs runbooks. 47...

Your runbooks are out of date. I don't know your team, but I'd bet money on it. Most teams write...

Battle-tested strategies for incident response and zero-downtime deployments Your...