Good Docs Describe, Bad Docs Prescribe

4 aard 1 7/25/2025, 4:28:55 PM rethinkingsoftware.substack.com ↗

Comments (1)

PaulHoule · 10s ago
There is more than one kind of documentation. Descriptions are great for understanding systems, but runbooks, checklists and such are useful prescriptions.

When you've got a crisis and need to restore the system from backup it's a huge relief to open up a binder and find step-by-step instructions to get it up and running again.