So erstellen Sie eine Dokumenten-Änderungshistorie
So bauen Sie eine Dokumenten-Änderungshistorie: die nötigen Spalten, warum das Protokoll ein separater, nur wachsender Datensatz sein muss, und der Verifizierungsschritt, den selbst gebaute Tabellen meist auslassen.
So funktioniert es
Trennen Sie das Protokoll vom Dokument
Legen Sie die Änderungshistorie in einem eigenen Artefakt ab (eine Tabelle auf der Titelseite oder ein eigenständiges Register), niemals als Absatz im Fließtext vergraben. Das Dokument ändert sich; das Protokoll ist von beiden das einzige, das nur wachsen darf.
Legen Sie die Spalten vor dem ersten Eintrag fest
Versionsnummer, Datum, Autor, eine allgemeinverständliche Beschreibung dessen, was sich geändert hat und warum, einen Verweis auf die ersetzte Version und wer den Eintrag verifiziert hat. Lassen Sie eine der letzten beiden weg, und es gibt keine Möglichkeit, einen geprüften Nachweis von der Selbstauskunft eines Autors zu unterscheiden.
Öffnen Sie den Eintrag vor der Bearbeitung, nicht danach
Protokollieren Sie einen offenen Eintrag (Nummer, Dokumentverknüpfung, zugewiesener Autor) in dem Moment, in dem eine Änderung freigegeben wird, bevor jemand die Datei öffnet. Ein nachträglich geschriebener Eintrag wird aus dem Gedächtnis rekonstruiert, genau der Fehlerfall, den ein Protokoll verhindern soll.
Schreiben Sie auf, was sich geändert hat, nicht dass sich etwas geändert hat
„Abschnitt 4 aktualisiert“ ist keine Beschreibung; „Freigabeschwelle von 500 € auf 2.000 € in Abschnitt 4 geändert“ ist eine. Erfassen Sie das Vorher und Nachher in klaren Worten, den Namen des Autors und das Datum, damit ein Leser die Änderung rekonstruieren kann, ohne die eigene Historie des Dokuments zu öffnen.
Verifizieren Sie den Eintrag gegen die tatsächliche Bearbeitung
Lassen Sie jemand anderen als den Autor die protokollierte Beschreibung mit dem tatsächlich im Dokument Geänderten vergleichen, bevor der Eintrag geschlossen wird. Bei Uneinigkeit klären Sie, ob das Dokument oder der Eintrag falsch ist: den Eintrag zu korrigieren ist für den Autor nicht immer ein Rückschritt.
Prüfen Sie geschlossene Einträge stichprobenartig, nicht jeden einzeln
Bauen Sie ein periodisches Audit, das eine Stichprobe geschlossener Einträge gegen ihre Dokumente prüft, nach einem Zeitplan, der zum Auditprogramm gehört statt zu einer Ad-hoc-Prüfung. Das ist, was das Protokoll vertrauenswürdig macht, ohne dass Sie es selbst erneut verifizieren müssen.
Häufig gestellte Fragen
Was ist der Unterschied zwischen einer Änderungshistorie und Versionskontrolle?
Eine Änderungshistorie ist das Artefakt: die Tabelle aus Version, Datum, Autor, Beschreibung und Prüfer. Versionskontrolle ist die Praxis, die diese Tabelle ehrlich hält: die Regel, dass nichts ohne Eintrag bearbeitet wird, dass Einträge nie im Nachhinein umgeschrieben werden, und dass jemand anderer als der Autor einen Eintrag gegen die Bearbeitung prüft. Sie können eine Änderungshistorie mit schwacher Versionskontrolle dahinter haben: die Tabelle existiert, aber niemand verifiziert je eine Zeile gegen die tatsächliche Bearbeitung.
Welche Spalten braucht eine Änderungshistorie-Tabelle?
Versionsnummer, Datum, Autor, eine allgemeinverständliche Beschreibung dessen, was sich geändert hat und warum, einen Verweis auf die ersetzte Version und (die eine Spalte, die die meisten selbst gebauten Tabellen auslassen) wer den Eintrag gegen die tatsächliche Bearbeitung verifiziert hat. Eine Zeile ohne die letzte Spalte ist die Selbstauskunft eines Autors, kein geprüfter Nachweis.
Sollte eine Änderungshistorie bearbeitet werden, um einen Fehler in einem alten Eintrag zu beheben?
Nein. Hängen Sie eine neue Zeile an, die den Datensatz korrigiert, statt die alte umzuschreiben; das Protokoll ist nur so vertrauenswürdig, wie seine Nur-wachsend-Historie intakt ist. War das Falsche das Dokument statt des Eintrags, gehört die Korrektur in eine neue Dokumentrevision, nicht in eine umgeschriebene Protokollzeile.
Reicht eine von Hand geführte Tabellenkalkulation für eine Änderungshistorie, oder brauche ich Software?
Eine Tabellenkalkulation funktioniert, bis jemand eine Zeile bearbeitet statt eine anzuhängen, was schwer zu verhindern und leicht zu übersehen ist. Die Versionshistorie von QueryChart schreibt das entsprechende Protokoll automatisch: ein Änderungsprotokoll mit Vorher-Nachher-Werten je Feld und dem Namen des Bearbeiters für jede Revision, einsehbar in einer Ansicht zum Versionsvergleich und jederzeit wiederherstellbar, unter /features/version-control. Das Diagramm oben zeigt die manuelle Version derselben Disziplin (ein Antrag, eine abgelegte Beschreibung, ein Verifizierungsschritt), unabhängig davon, welches Werkzeug sie ausführt.