Zum Inhalt springen
Techniken · Neu

Betriebswissen als Markdown in Git

Runbooks und Betriebsdoku versioniert, für Menschen und KI lesbar.

Runbooks, Betriebskonzepte und Architekturentscheidungen liegen als Markdown im Git. Jede Änderung ist versioniert und lässt sich per Merge Request prüfen. Die Inhalte sind unabhängig von einem Werkzeug und lassen sich ohne Umwandlung durchsuchen, auch von KI-Systemen.

Ein Wiki bleibt sinnvoll, wenn viele Fachbereiche mitschreiben. Entscheidend ist nicht das Format, sondern eine einheitliche Struktur und eine Pflege, die fester Teil von Change und Incident ist.

  • Betriebsteams ohnehin mit Git arbeiten
  • eine KI-gestützte Suche in der Betriebsdoku geplant ist
  • Änderungen an der Dokumentation nachvollziehbar sein sollen
Passt nicht, wenn …
  • die meisten Autoren nicht mit Git arbeiten wollen; dann ein Wiki mit fester Struktur
  • Dokumente vor allem als formale Nachweise mit Unterschrift gebraucht werden

Welche Werkzeuge passen zu Ihrem Betrieb?

Im Erstgespräch prüfen wir Ihre Werkzeuglandschaft und zeigen, wo eine Änderung lohnt und wo nicht.