Skimming a Runbook Can Make You Miss a Critical Word Like 'Not'
A developer working through a failover runbook restarted a replica that the step said not to restart, because they had skimmed the instruction while under time pressure. The article explains that reading is made up of quick eye movements called saccades, so readers skip many short words, including negations like 'not', which are easy to overlook when reading fast. The author argues that skimming is the wrong approach for high-stakes documents and recommends slowing down, reading steps aloud, and writing instructions in clearer terms. Specifically, the runbook should state to wait until replication lag reads zero, rather than relying on a negative instruction. The piece is written by Serguey Asael Shinder and is published on DEV Community.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in