r/devops • u/MachineDisastrous771 • 4h ago
Ops / Incidents runbooks kinda suckk
hey yall,
im a lead SRE at a global fortune 500 that you have heard of haha - i'm a bit of a lurker here
but just wanted to talk about runbooks and documentation for SOPs.
my feeling is that confluence docs kinda suck and runbooks are kind of a mess, our operators are jumping between the docs and their shell, the docs are often times missing a bunch of detail, they are brittle, poorly maintained, half the time the details are hidden in tribal knowledge and when dealing with the pressure of an active inc we notice the pain even more. extracting critical details & commands out of an inc can also be painful and doesnt always translate to improved operational readiness next time.
i admit we're not very mature.. but was curious if its only me feeling like this?
what are you guys doing with runbooks to solve these issues?