Hi all, I'm curious what people are using for runbooks and playbooks? Is it markdown in git? Have you looked at ways to make your runbooks executable and have rich visualizations e.g Runme.Dev or Datadog Notebooks? I really like this pattern. I used Datadog notebooks at my last job. I really liked that if I was working a problem I could combine analysis/exposition with rich interactive graphs. This was way better than copying links/PNGs into github issues or Google Docs.

We've used MKDocs and published them. You have the advantage of markdown but a web interface to be interactive with. If you go all in on Datadog its another thing you'd have to migrate away should you change providers

Do people just copy and paste commands into the shell?

Pretty much, or it links to a repo which has pre-approved scripts to be ran

In my case, a starting point with a catalog of simple markdown docs covering common operations and most importantly disaster recovery scenarios with some handy copy&paste commands, context and where to escalate. Eventually, some of these runbooks were successively automated in a various ways: • Azure Logic Apps • Terrafrom / IaC • Argo Events • Bash

We've had some early success with Warp's Notebooks and Workflows, albeit with a lean startup team, so ymmv.

@Steve Baer What made you pick Warp Notebooks? Did you also consider RunMe.Dev and if so what made you choose Warp?