Adopt Techniques · New
Operational knowledge as Markdown in Git
Runbooks and operational documentation under version control, readable by people and AI.
Runbooks, operating concepts and architecture decisions are stored as Markdown in Git. Every change is versioned and can be reviewed via a merge request. The content is independent of any single tool and can be searched without conversion, including by AI systems.
A wiki still makes sense when many business departments contribute. What matters is not the format but a consistent structure and maintenance that is a fixed part of change and incident management.
A good fit if …
- operations teams already work with Git
- AI-assisted search across the operational documentation is planned
- changes to the documentation need to be traceable
Not a good fit if …
- most authors do not want to work with Git; in that case, use a wiki with a fixed structure
- documents are mainly needed as formal, signed records
Which tools suit your operations?
In an initial call we review your tool landscape and show where a change pays off and where it does not.