Ask HN: What software exists for playbooks/runbooks?

We just use the company wiki. We are thinking of moving that data to the service GitHub repo instead to keep the data more local. It is easy to forget to update documentation all ready, might as well reduce the places you have to update.

Ideally all alerts are either self-evident or link to proper remediation steps to attempt when auto-remediation is not available. The new person on the team should have enough info to do basic triage at 3am at the very least given a decent runbook/alert documentation.

Run-books are an anti-pattern designed to resolve issues that shouldn't be present in well written software.

Similar to how emergency procedures on boats and airplanes are an anti pattern designed to resolve sinking or crashing?

I admire your positive outlook, but the world is messy and things fail all the time. Even well written software can go poof when us-east-1 goes down or your fileserver goes poof.

So throw away the disaster recover plan and blame the vendors if anything goes wrong? Got it.

In case of fire, blame vendor.

We just use markdown on github