Review ist eine Verantwortungskette
Autor, fachlichen Reviewer, Redaktion und finalen Owner definieren. Rollen dürfen kombiniert werden, Verantwortung muss sichtbar bleiben.
Unterschiedliche Fragen an unterschiedliche Reviewer
SME prüft Verhalten, Redaktion Struktur und Terminologie, Product Owner Zusagen und Scope. „Sieht gut aus?“ führt zu oberflächlicher Freigabe.
Änderungen leicht prüfbar machen
Fokussierte Pull Requests, Preview und klare Zusammenfassung. Riesige gemischte Diffs werden schlechter geprüft.
Wartezeit begrenzen
Reviewer explizit zuweisen und Eskalation definieren.
Automatisieren, was Menschen nicht diskutieren müssen
Links, Metadaten, Rechtschreibung, Terminologie und Build-Gültigkeit automatisiert prüfen. Menschliche Aufmerksamkeit gehört Korrektheit, Nutzen und Risiko.
Praxisbeispiel
Um „Dokumentations-Reviews organisieren“ in eine belastbare Praxis zu verwandeln, nimm ein Dokument, das sich in dieser Woche wirklich ändert: eine Prozedur, Release-Seite, Onboarding-Strecke oder Troubleshooting-Seite. Notiere vor der Bearbeitung, wer sie nutzt, wodurch eine Änderung ausgelöst wird, wer die Fakten bestätigen kann und was der Leser anschließend tun können soll.
Führe eine echte Änderung vollständig durch. Ändere nur einen Fakt, einen Schritt oder eine Verantwortung und beobachte, wo Information verloren geht. Prüfe:
- ist das erwartete Ergebnis ohne Rückfrage verständlich;
- gibt es einen Owner für die nächste Aktualisierung;
- kann ein Reviewer den geänderten Fakt verifizieren;
- bleibt die Seite ohne veraltetes Material verständlich.
Eine Dokumentationspraxis ist dann vertrauenswürdig, wenn sie echte Änderungen übersteht – nicht nur, wenn sie in einem statischen Beispiel ordentlich aussieht.
Kurzer Redaktionscheck
- Review ist eine Verantwortungskette. Autor, fachlichen Reviewer, Redaktion und finalen Owner definieren.
- Unterschiedliche Fragen an unterschiedliche Reviewer. SME prüft Verhalten, Redaktion Struktur und Terminologie, Product Owner Zusagen und Scope.
- Änderungen leicht prüfbar machen. Fokussierte Pull Requests, Preview und klare Zusammenfassung.
- Wartezeit begrenzen. Reviewer explizit zuweisen und Eskalation definieren.
