Glossar

Dokumentationsarchitektur

Die Dokumentationsarchitektur beschreibt die Struktur, Ebenen, Sichten und Beziehungen der gesamten Dokumentation einer IT-Organisation. Sie legt fest, welche Dokumententypen es gibt, wie sie hierarchisch und thematisch zusammenhängen und wie IT-Betriebs-, Anwendungs-, Service-, ISMS-, Notfall- sowie kunden- und lieferantenbezogene Dokumente in einer konsistenten Gesamtstruktur organisiert werden – als Grundlage für ein effizientes und auditfähiges Dokumentationsmanagement.

Die Dokumentationsarchitektur im Überblick

Die Dokumentationsarchitektur beschreibt das „Bau- und Ordnungskonzept“ der Dokumentation. Sie beantwortet Fragen wie:

  • Welche Dokumententypen (z. B. Richtlinien, Konzepte, Prozesse, Handbücher, Arbeitsanweisungen, Aufzeichnungen) gibt es?
  • Wie sind diese hierarchisch angeordnet (z. B. strategische Managementdokumente, operative Managementdokumente, operative Umsetzungsdokumente, Nachweisdokumente)?
  • Wie werden die Dokumentationen der verschiedenen Aufgabenbereiche miteinander verknüpft?
  • Wo werden Dokumente abgelegt, wie werden sie gefunden, wie werden sie gesteuert (Versionierung, Freigabe, Gültigkeit)?
  • Wie werden Dokumente verschiedenen Sichten zugeordnet (z. B. nach Systemen/Plattformen, Anwendungen, Services, Prozessen, Organisationseinheiten)?

Eine gut durchdachte Dokumentationsarchitektur ist die Voraussetzung dafür, dass Dokumentation:

  • übersichtlich, konsistent und schnell auffindbar ist,
  • in Projekten und Changes systematisch mitgepflegt wird,
  • regulatorische Anforderungen effektiv unterstützt,
  • als Arbeitsinstrument im Betrieb, in Audits und Notfällen tatsächlich genutzt werden kann – statt nur als „Ablage“.

Sie bildet damit das Rückgrat des Dokumentationsmanagements. Ohne eine durchdachte Dokumentationsarchitektur entstehen leicht „Dokumentensilos“: jedes Team, jede Anwendung, jeder Provider dokumentiert „igendwie“, was zu Lücken, Doppelungen, Widersprüchen und großen Suchaufwänden führt.

Beispiele

Kernaufgabe der Dokumentationsarchitektur ist, die unterschiedlichen Welten miteinander zu verbinden:

IT-Betrieb (System- und Plattformbetrieb)

  • Zuordnung von Betriebskonzepten, Systemdokumentationen, Betriebshandbüchern, Arbeitsanweisungen, technischen Plänen und Betriebsaufzeichnungen zu Systemen/Plattformen.
  • Verknüpfung mit ISMS- und Notfalldokumenten (z. B. Sicherheits- und Notfallkonzepte).

Anwendungsmanagement / Anwendungsbetrieb

  • Abbildung des Anwendungslebenszyklus in der Dokumentenlandschaft (Anforderung, Design, Entwicklung, Test, Übergabe, Betrieb, Ablösung).
  • Klare Einordnung von Anwendungsdokumentation (Fachkonzepte, Anwendungs-/Architekturdoku, Betriebs- und Supportdoku, Release-/Change-Doku).

IT-Servicemanagement

  • Einbettung von Servicekatalog, Servicebeschreibungen, SLAs/OLAs und ITSM-Prozessdokumentation (Incident, Change, Problem usw.) in die Architektur.
  • Verknüpfung von Services mit System-, Betriebs-, Sicherheits- und Notfalldokumentation.

Kunden- und Lieferantenmanagement / Outsourcing

  • Definition, wo und wie Verträge, Leistungsbeschreibungen, SLAs, AV-Verträge, Provider-Konzepte, Reports und Nachweise in die Architektur eingebunden sind.
  • Klare Kennzeichnung, welche Dokumente intern verantwortet und welche vom Dienstleister geliefert werden.
  • Integration externer Dokumente (z. B. Provider-Betriebshandbuch, Sicherheitskonzept des Providers) in die eigene Struktur.

ISMS (Informationssicherheit)

  • Positionierung von Sicherheitsleitlinien, ISMS-Konzept, themenspezifischen Richtlinien, Risiko-/Maßnahmenunterlagen und sicherheitsrelevanten Aufzeichnungen in der Pyramide.
  • Querverweise von ISMS-Dokumentation zu IT-Betriebs-, Anwendungs- und Servicedokumentation.

Notfallmanagement

    • Verortung von Notfallkonzepten, Notfallhandbüchern, Wiederanlaufplänen, Alarmierungs- und Kommunikationsplänen sowie Übungsnachweisen.
    • Systematische Verknüpfung zu den jeweils betroffenen Systemen, Anwendungen und Services.

Abgrenzung und Synonyme

Abgrenzung zur IT-Architektur

  • IT-Architektur beschreibt Systeme, Anwendungen, Schnittstellen und Infrastruktur.
  • Dokumentationsarchitektur beschreibt, wie die dazugehörige Dokumentation aufgebaut und strukturiert ist. Beide sollten konsistent aufeinander abgestimmt werden.

Abgrenzung zu einzelnen Dokumenten oder Vorlagen

  • Ein einzelnes Betriebshandbuch oder eine Vorlage ist Teil der Dokumentationsarchitektur.
  • Die Architektur selbst ist das Meta-Konzept, das festlegt, welche Dokumente es geben soll, in welchem Verhältnis sie zueinander stehen und wie sie verwaltet werden.

Synonyme

  • Dokumentenarchitektur
  • Architektur der IT-Dokumentation

Dokumentenstruktur / Dokumentenlandschaft (im weiteren Sinne)

Verwandte Begriffe

FAQ Dokumentationsarchitektur

Entweder in einem eigenständigen Konzept oder im Dokumentationskonzept. Dort kann die Architektur beschrieben werden, ergänzt um Prozesse, Rollen und Toolzuordnungen. Sie sollte zusätzlich als grafische Übersicht (z. B. Ebenenmodell) visualisiert werden.

Sie sollte klar definieren, welche dokumentierten Informationen intern, welche beim Dienstleister geführt werden, wie Provider-Dokumente in die eigene Struktur eingebunden werden und welche Schnittstellendokumente es gibt (z. B. gemeinsam definierte Betriebskonzepte, Rollen-/Verantwortungsübersichten, Eskalationsmatrizen).

Regularien fordern nicht explizit eine „Dokumentationsarchitektur“, verlangen aber identifizierbare, aktuelle dokumentierte Informationen, geregelte Dokumentenlenkung und klare Nachweisführung. Eine gute Dokumentationsarchitektur ist der pragmatische Weg, diese Anforderungen strukturiert zu erfüllen.

Nach oben scrollen