7.2 Knowledge-Artikel, Runbooks und FAQ

Kurz erklärt

Knowledge-Artikel, Runbooks und FAQ sind unterschiedliche Formen von dokumentiertem Wissen.

Knowledge-Artikel helfen bei wiederkehrenden Fragen, Fehlerbildern, Workarounds oder Standardlösungen.

Runbooks beschreiben konkrete betriebliche Abläufe Schritt für Schritt.

FAQ beantworten häufige Fragen kurz und verständlich.

Entscheidend ist, dass die Wissensform zur Zielgruppe, zum Risiko und zum Anwendungsfall passt.


Warum verschiedene Wissensformen wichtig sind

Nicht jedes Wissen sollte gleich dokumentiert werden.

Ein Benutzer benötigt eine andere Anleitung als ein Administrator.

Der Service Desk benötigt andere Informationen als ein Fachteam.

Beispiele:

Wenn alle Informationen in einem einzigen langen Dokument stehen, wird Wissen schwer nutzbar.

Besser ist eine passende Struktur nach Zweck und Zielgruppe.


Knowledge-Artikel

Ein Knowledge-Artikel beschreibt nutzbares Wissen zu einem konkreten Thema.

Typische Inhalte:

Knowledge-Artikel können intern oder für Benutzer sichtbar sein.

Wichtig ist, dass sie auffindbar, aktuell und verständlich sind.


Typische Knowledge-Artikel

Artikeltyp Beispiel
Lösungsartikel VPN verbindet nach Ruhezustand nicht mehr
Workaround-Artikel PDF-Export schlägt fehl – alternative Ausgabe nutzen
Known-Error-Artikel Client-Version 5.8 verliert VPN-Tunnelzustand
Benutzerartikel Passwort über Self-Service zurücksetzen
Supportartikel Erstdiagnose bei DNS-Problemen
Technischer Artikel Zertifikat für Webservice prüfen
Sicherheitsartikel Verdächtige E-Mail melden
Serviceartikel Supportzeiten und Kontaktweg für Mitarbeiterportal

Der Artikeltyp sollte klar sein, damit Inhalt und Detailtiefe passen.


Runbooks

Ein Runbook ist eine konkrete Schritt-für-Schritt-Anleitung für wiederkehrende Betriebsaufgaben.

Typische Runbooks:

Runbooks sind besonders wichtig bei Aufgaben, die korrekt, sicher und wiederholbar ausgeführt werden müssen.


FAQ

FAQ bedeutet „Frequently Asked Questions“.

Eine FAQ beantwortet häufige Fragen kurz und verständlich.

Beispiele:

FAQ eignen sich besonders für Benutzerwissen.

Sie ersetzen aber keine vollständigen Runbooks oder technischen Supportartikel.


Knowledge-Artikel, Runbook und FAQ unterscheiden

Form Zweck Zielgruppe Beispiel
Knowledge-Artikel Wissen zu Fehler, Lösung oder Workaround bereitstellen Benutzer, Service Desk, Fachteam VPN-Fehler erkennen und lösen
Runbook betriebliche Aufgabe sicher ausführen IT-Betrieb, Fachteam, Service Desk Dienst kontrolliert neu starten
FAQ häufige Fragen kurz beantworten Benutzer, Service Desk Wie setze ich mein Passwort zurück?

Die Grenzen können sich überschneiden.

Wichtig ist, dass der Inhalt im Alltag gut nutzbar ist.


Zielgruppe zuerst klären

Vor dem Schreiben muss klar sein:

Ein Benutzerartikel sollte anders geschrieben sein als ein internes Runbook.


Beispiel: Gleiches Thema, verschiedene Zielgruppen

Thema:

VPN verbindet nicht.

Benutzerartikel

Service-Desk-Artikel

Fachteam-Runbook

Ein Thema kann also mehrere Artikel benötigen.


Gute Titel

Der Titel entscheidet oft, ob ein Artikel gefunden wird.

Ungeeignet:

Fehler 0x23A bei Authentifizierung

Besser:

Anmeldung im Mitarbeiterportal schlägt fehl

Ungeeignet:

Netzwerkproblem nach Standby

Besser:

VPN verbindet nach Ruhezustand nicht mehr

Ungeeignet:

Client Workaround

Besser:

VPN-Client vollständig neu starten

Ein guter Titel nutzt Begriffe, nach denen Zielgruppen tatsächlich suchen.


Suchbegriffe berücksichtigen

Artikel sollten typische Begriffe enthalten.

Beispiele:

Beispiel:

Ein Artikel zu Mehrfaktor-Authentifizierung sollte auch Begriffe enthalten wie:

So wird der Artikel besser gefunden.


Struktur eines Knowledge-Artikels

Ein guter Knowledge-Artikel kann enthalten:

Nicht jeder Artikel benötigt alle Punkte.

Die Struktur sollte zum Zweck passen.


Beispielstruktur für Service-Desk-Artikel

Abschnitt Inhalt
Titel VPN verbindet nach Ruhezustand nicht mehr
Kurzbeschreibung bekannter Fehler bei bestimmter Clientversion
Symptome Verbindung bricht nach Standby ab
Betroffen Windows-Notebooks mit Client-Version 5.8
Prüfschritte Version prüfen, Fehlerbild abgleichen
Workaround Client vollständig beenden und neu starten
Eskalation bei anderer Version an Netzwerkteam
Verknüpfung Known Error, Problem Record, Change
Review nach Rollout neuer Clientversion prüfen

Diese Struktur hilft, Fälle schnell und einheitlich zu bearbeiten.


Struktur eines Runbooks

Ein Runbook sollte besonders genau sein.

Mögliche Struktur:

Bei kritischen Aufgaben sind Abbruchkriterien und Rollback besonders wichtig.


Beispielstruktur für Runbook

Abschnitt Inhalt
Zweck Dienst kontrolliert neu starten
Voraussetzungen Wartungsfenster oder Freigabe vorhanden
Risiko Benutzer können kurzzeitig nicht arbeiten
Vorbereitung Monitoring prüfen, aktuelle Sessions prüfen
Schritte Dienst stoppen, Status prüfen, Dienst starten
Prüfung Anmeldung, Logs, Monitoring
Abbruchkriterium Dienst startet nicht innerhalb definierter Zeit
Rollback vorherige Konfiguration wiederherstellen
Eskalation Fachteam oder Bereitschaft informieren

Runbooks sollten so geschrieben sein, dass sie auch unter Zeitdruck verständlich bleiben.


Struktur einer FAQ

Eine FAQ sollte kurz und direkt sein.

Mögliche Struktur:

Beispiel:

Frage

Wie setze ich mein Passwort zurück?

Antwort

Nutzen Sie den Self-Service-Passwort-Reset im Serviceportal. Halten Sie Ihre zweite Anmeldemethode bereit. Wenn Sie keinen Zugriff mehr auf MFA haben, erstellen Sie ein Ticket an den Service Desk.

FAQ sollten nicht zu langen Handbüchern werden.


Benutzerartikel schreiben

Benutzerartikel sollten:

Ungeeignet:

Prüfen Sie, ob Ihr Identity Provider den Token korrekt verarbeitet.

Besser:

Öffnen Sie die Authenticator-App und bestätigen Sie die Anmeldung erneut.


Interne Supportartikel schreiben

Interne Supportartikel dürfen technischer sein.

Sie sollten enthalten:

Service-Desk-Artikel sollten schnell nutzbar sein.

Sie sollten keine unnötig langen Hintergrundtexte enthalten.


Technische Fachartikel schreiben

Technische Fachartikel können detaillierter sein.

Geeignet sind:

Wichtig:

Technische Fachartikel sollten trotzdem strukturiert und überprüfbar sein.

Ein unstrukturierter Expertennotizzettel hilft nur begrenzt.


Runbooks und Sicherheit

Runbooks können sicherheitskritische Schritte enthalten.

Beispiele:

Dann müssen enthalten sein:

Nicht jedes Runbook darf für alle sichtbar sein.


Screenshots verwenden

Screenshots können helfen, wenn Benutzer eine Oberfläche bedienen müssen.

Vorteile:

Risiken:

Screenshots sollten regelmäßig geprüft und bei Changes aktualisiert werden.


Tabellen verwenden

Tabellen eignen sich gut für Varianten.

Beispiel:

Situation Vorgehen
Benutzer kennt Passwort Passwort über Portal ändern
Benutzer kennt Passwort nicht Self-Service-Reset nutzen
Benutzer hat neues Smartphone MFA-Methode neu registrieren
Benutzer hat keinen MFA-Zugriff Ticket an Service Desk erstellen

Tabellen helfen, Entscheidungen schnell sichtbar zu machen.


Checklisten verwenden

Checklisten sind sinnvoll für wiederkehrende Prüfungen.

Beispiele:

Eine gute Checkliste ist kurz, eindeutig und vollständig genug.

Sie sollte keine wichtigen Entscheidungen verstecken.


Entscheidungsbäume verwenden

Entscheidungsbäume helfen bei Diagnose.

Beispiel:

Benutzer kann sich nicht anmelden
    ↓
Passwort bekannt?
    ↓
ja → MFA prüfen
    ↓
nein → Self-Service-Reset prüfen
    ↓
kein MFA-Zugriff → Service Desk Ticket
    ↓
Konto gesperrt → Entsperrprozess prüfen

Entscheidungsbäume sollten nicht zu komplex werden.

Bei zu vielen Verzweigungen ist eine Tabelle oft besser.


Artikel mit Services und CIs verknüpfen

Knowledge-Artikel sollten mit relevanten Services oder Configuration Items verknüpft werden.

Vorteile:

Beispiel:

Ein VPN-Artikel wird verknüpft mit:


Artikel mit Incidents verknüpfen

Wenn ein Artikel zur Lösung eines Incidents genutzt wurde, sollte er im Ticket verknüpft werden.

Nutzen:

Wenn viele Tickets trotz Artikel entstehen, sollte geprüft werden, ob der Artikel unklar, nicht auffindbar oder technisch unzureichend ist.


Artikel mit Problems und Known Errors verknüpfen

Bei bekannten Fehlern ist die Verknüpfung besonders wichtig.

Ein Known-Error-Artikel sollte enthalten:

Dadurch können zukünftige Incidents schneller bearbeitet werden.


Artikel mit Changes und Releases verknüpfen

Changes und Releases können Knowledge-Artikel verändern.

Beispiele:

Deshalb sollte bei Change- und Release-Abschluss geprüft werden:

Welche Knowledge-Artikel müssen aktualisiert werden?


Versionierung von Artikeln

Bei wichtigen Artikeln kann Versionierung sinnvoll sein.

Zu dokumentieren ist:

Versionierung hilft bei Nachvollziehbarkeit.

Besonders wichtig ist sie bei sicherheitskritischen Runbooks, Workarounds und Betriebsanleitungen.


Review und Ablaufdatum

Artikel sollten regelmäßig geprüft werden.

Besonders wichtig bei:

Ein Ablaufdatum oder Review-Datum verhindert, dass veraltetes Wissen dauerhaft als aktuelle Lösung erscheint.


Owner für Artikel

Jeder wichtige Artikel sollte einen Owner besitzen.

Der Owner ist verantwortlich für:

Ohne Owner bleibt unklar, wer einen Artikel korrigieren darf oder muss.


Freigabe von Artikeln

Nicht jeder Artikel benötigt dieselbe Freigabe.

Beispiele:

Artikel mögliche Freigabe
einfache FAQ Service Desk oder Knowledge Owner
Benutzeranleitung Service Owner oder Kommunikation
technisches Runbook Fachteam
Sicherheitsartikel Information Security
Workaround mit Risiko Fachteam und Service Owner
Known Error Problem Management oder Fachteam

Die Freigabe sollte zum Risiko passen.

Zu viel Freigabeaufwand verhindert schnelle Wissensnutzung.


Zugriffsschutz

Artikel können unterschiedliche Sichtbarkeit haben.

Beispiele:

Zu prüfen ist:

Falsche Sichtbarkeit kann Sicherheits- oder Datenschutzrisiken erzeugen.


Qualität eines Artikels prüfen

Ein Artikel ist gut, wenn:

Ein Artikel ist nicht gut, nur weil er lang ist.


Häufige Qualitätsprobleme

Problem Folge
Titel unklar Artikel wird nicht gefunden
zu technisch Benutzer verstehen ihn nicht
zu allgemein Service Desk kann ihn nicht anwenden
kein Owner Artikel veraltet
kein Review Aktualität unklar
keine Eskalation falsche Bearbeitung
keine Risiken unsichere Anwendung
keine Servicezuordnung Artikel wird nicht im richtigen Kontext gefunden
veraltete Screenshots Benutzer folgen falschen Schritten

Kurzartikel und Tiefendokumentation kombinieren

Manche Themen brauchen zwei Ebenen.

Kurzartikel

Tiefendokumentation

Der Kurzartikel verweist auf die Tiefendokumentation.

So bleibt der Artikel im Support schnell nutzbar, ohne Fachdetails zu verlieren.


Beispiel: Benutzerartikel MFA

Titel

MFA auf einem neuen Smartphone einrichten

Zielgruppe

Benutzer

Inhalt

Nicht enthalten


Beispiel: Service-Desk-Artikel VPN

Titel

VPN verbindet nach Ruhezustand nicht mehr

Zielgruppe

Service Desk

Inhalt

Nutzen

Der Service Desk erkennt den bekannten Fall schneller und handelt einheitlich.


Beispiel: Runbook Zertifikat erneuern

Titel

Runbook: TLS-Zertifikat für Mitarbeiterportal erneuern

Zielgruppe

Plattform-Team

Inhalt

Besonderheit

Dieses Runbook ist sicherheits- und servicekritisch und benötigt fachliche Prüfung.


Beispiel: FAQ Passwort

Frage

Wie setze ich mein Passwort zurück?

Antwort

Nutzen Sie den Self-Service-Passwort-Reset im Serviceportal.

Wenn Sie keinen Zugriff auf Ihre zweite Anmeldemethode haben, erstellen Sie ein Ticket an den Service Desk.

Ausführliche Anleitung: Passwort und MFA verwalten


Typische Fehler

Fehler 1

Alle Informationen werden in einen einzigen langen Artikel geschrieben.


Fehler 2

Zielgruppe ist nicht klar.


Fehler 3

Benutzerartikel enthalten interne technische Details.


Fehler 4

Runbooks enthalten keine Abbruchkriterien.


Fehler 5

Workarounds enthalten keine Risiken.


Fehler 6

Titel orientieren sich an Technik statt an Suchbegriffen der Zielgruppe.


Fehler 7

Artikel haben keinen Owner.


Fehler 8

Review-Datum fehlt.


Fehler 9

Screenshots werden nach Releases nicht aktualisiert.


Fehler 10

Knowledge-Artikel sind nicht mit Services, CIs, Incidents oder Problems verknüpft.


Fehler 11

Veraltete Artikel bleiben sichtbar.


Fehler 12

FAQ wird als Ersatz für vollständige Supportartikel verwendet.


Checkliste Knowledge-Artikel


Checkliste Runbook


Checkliste FAQ


Checkliste Artikelqualität


Bedeutung für Fachinformatiker für Systemintegration

Fachinformatiker erstellen und nutzen viele Wissensformen.

Im Alltag bedeutet das:

Gute Wissensdokumentation macht Betrieb weniger abhängig von Einzelpersonen und verbessert die Qualität im Support.


Zusammenfassung

Wissensbedarf erkennen

Zielgruppe bestimmen

passende Wissensform wählen

Knowledge-Artikel, Runbook oder FAQ erstellen

Inhalt fachlich prüfen

Service, CI oder Problem verknüpfen

Artikel veröffentlichen

Nutzung und Feedback auswerten

Artikel aktualisieren oder archivieren


Merksätze

Die Form des Wissens muss zum Zweck passen.

Benutzerartikel, Supportartikel und Runbooks brauchen unterschiedliche Detailtiefe.

Ein guter Titel entscheidet oft, ob Wissen gefunden wird.

Runbooks benötigen klare Schritte, Prüfpunkte und Abbruchkriterien.

FAQ beantworten häufige Fragen, ersetzen aber keine vollständige Betriebsdokumentation.

Jeder wichtige Artikel braucht Owner, Review und passende Sichtbarkeit.

Wissen ist nur nützlich, wenn es gefunden, verstanden und gepflegt wird.


Verwandte Seiten


Quellen und Versionsstand

Offizielle Grundlagen

Ergänzende Praxiseinordnung

Einordnung

Die dargestellten:

sind herstellerneutrale Praxisempfehlungen.

ITIL schreibt keine universelle:

für alle Organisationen vor.

Die konkrete Umsetzung muss an:

angepasst werden.

Behandelter Framework-Stand: ITIL Version 5
Zusätzlich berücksichtigt: aktuelle ITIL-4-Practice-Guidance
Fachlicher Stand: August 2026


Revision #1
Created 2 August 2026 16:18:23 by Admin
Updated 2 August 2026 16:21:59 by Admin