IT-Dokumentation im Mittelstand: aktuell halten

Das eigentliche Problem: Aktuellhalten, nicht Erstellen

Fast jedes Unternehmen hat schon einmal versucht, seine IT zu dokumentieren. Das Erstellen ist auch nicht das Problem – ein motivierter Nachmittag bringt eine passable erste Version. Das Problem beginnt am Tag danach.

Denn eine IT verändert sich täglich: Ein neues Notebook wird eingerichtet, ein neuer Mitarbeiter bekommt zusätzliche Rechte, eine Software wird durch Updates verändert oder ganz abgelöst, eine Konfiguration angepasst, ein Vertrag verlängert. Jede dieser Änderungen – und auch jede Wartung – müsste jemand kontinuierlich von Hand in die Dokumentation übertragen. Im Tagesgeschäft passiert das nicht – nicht aus Nachlässigkeit, sondern weil die manuelle Pflege in kleinen IT-Teams immer die Aufgabe ist, die warten kann. Nach einem halben Jahr bildet das Dokument einen Zustand ab, den es nicht mehr gibt – von einer aktuellen Dokumentation ist es weit entfernt.

Werkzeuge, Vorlagen und Standards für die IT-Dokumentation

Um Ordnung in die IT-Dokumentation zu bringen, greifen viele Unternehmen zu Werkzeugen. Die Bandbreite reicht von der einfachen Word- oder Excel-Vorlage über Wikis bis zu spezialisierten Lösungen zur IT-Dokumentation. Wer es strukturierter angeht, setzt auf sogenannte Configuration Management Databases (CMDB) – Werkzeuge wie i-doit erfassen Infrastrukturkomponenten und ihre Abhängigkeiten, für Netzwerkdiagramme kommt oft draw.io zum Einsatz.

Eine gute Vorlage oder ein Template gibt Struktur vor und sorgt für einheitliche Dokumentationsstandards – so entsteht eine strukturierte Dokumentation, in der sich auch neue Kollegen zurechtfinden. Wichtig ist dabei eine zentrale Ablage: alle relevanten Informationen an einem Ort, damit im Bedarfsfall ein schneller Zugriff auf relevante Informationen möglich ist und nicht jeder in eigenen Notizen sucht.

Doch hier lauert ein Denkfehler. Ein Werkzeug, eine Vorlage oder ein Dokumentationsstandard beantwortet die Frage, wie dokumentiert wird – nicht die Frage, ob es kontinuierlich geschieht. Auch die beste CMDB veraltet, wenn niemand sie pflegt. Das eigentliche Problem – die Aktualität – lösen Tools allein nicht.

Der Ausweg: Dokumentation als Nebenprodukt des Betriebs

Der Denkfehler steckt in der Trennung: Betrieb hier, Dokumentation dort. Solange beides getrennt ist, wird die Dokumentation immer hinterherhinken. Die Lösung besteht darin, beides zusammenzuführen – die Dokumentation entsteht direkt aus dem laufenden IT-Betrieb.

Genau so arbeitet kjello. Wenn Geräte, Konten und Software ohnehin über ein zentrales Portal verwaltet werden, ist der aktuelle Stand jederzeit sichtbar: Jedes eingerichtete Gerät steht automatisch im Inventar, jedes On- und Offboarding aktualisiert die Konten- und Rechteübersicht, jede Lizenz ist erfasst. Die Dokumentation ist dann kein Dokument mehr, das jemand pflegt, sondern ein lebendes Abbild der Realität. Sie kann gar nicht veralten, weil sie nichts anderes ist als der aktuelle Zustand des Systems. So entsteht eine belastbare, jederzeit aktuelle Dokumentation ganz ohne zusätzlichen Pflegeaufwand – das schont knappe IT-Ressourcen und bringt eine spürbare Effizienzsteigerung im IT-Betrieb. Wie dieses Zusammenspiel funktioniert, zeigt die Produktseite.

Was Sie trotzdem bewusst dokumentieren sollten

Automatik erfasst den Ist-Zustand der Technik – nicht aber das Wie und Warum. Drei Dinge bleiben eine bewusste Aufgabe:

• IT-Prozesse und Besonderheiten: warum eine Konfiguration so gewählt wurde, welche technischen Details und Eigenheiten ein Fachsystem hat, wie bestehende Prozesse ablaufen und wer wofür zuständig ist. Klare Verantwortlichkeiten gehören genauso dokumentiert wie die Technik selbst.
• Wissen und Einarbeitung: eine kurze Benutzerdokumentation und die Schulung neuer Mitarbeiter sind aktive Wissenssicherung – IT-Wissen, das kein System automatisch erfasst.
• Der Notfallplan: Abläufe und Kontakte für den Fall, dass Systeme ausfallen – idealerweise auch offline verfügbar.

Sinnvoll ist außerdem, diesen bewusst gepflegten Teil in regelmäßigen Reviews zu überprüfen – etwa im Rahmen ohnehin anstehender IT-Projekte. Diese Elemente sind Teil eines soliden Sicherheitsfundaments, das wir in der IT-Sicherheits-Checkliste für KMU ausführen. Und wenn Ihr Unternehmen unter NIS2 fällt, wird die nachweisbare Dokumentation ohnehin zur Pflicht – unser NIS2-Check zeigt, ob das der Fall ist.

Eine IT-Dokumentation, die sich selbst aktuell hält, ist kein Luxus für Konzerne. Für den Mittelstand ist sie eine strategische Investition und zugleich die günstigste Versicherung gegen den Tag, an dem die IT-Person nicht erreichbar ist – und die Systeme trotzdem laufen müssen.