Use cases

An mdsh document is the steps and the record of running them, in one markdown file. That suits work that is done by hand today from a wiki page or a README: the page becomes something you run, and the run becomes a report you can send.

Each use case below comes with a runbook from examples/runbooks and the report one run of it made, as PDF, HTML and markdown. CI runs every runbook there on each change, so they keep working.

• RunbooksDeploys and incident steps that run, ask before the risky part, and leave a record.
• ReportsScheduled checks whose output is the report, as PDF, HTML or markdown.
• Setup checklistsOnboarding and machine checks that tell people what is missing.