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.
Eine Dokumenten-Änderungshistorie ist das Artefakt (eine Tabelle aus Version, Datum, Autor, Beschreibung und Prüfer), das eine Versionskontrollpraxis erzeugt und korrekt hält.
Kurz gesagt
- Die Änderungshistorie ist das Artefakt (eine Tabelle); Versionskontrolle ist die Praxis, die sie korrekt hält.
- Mindestspalten: Version, Datum, Autor, Beschreibung, Verweis auf Vorgängerversion, verifiziert von.
- Nur wachsend: Beheben Sie einen falschen Eintrag mit einer neuen Zeile, niemals durch Bearbeiten der alten.
- Ein Eintrag, den niemand gegen die tatsächliche Bearbeitung geprüft hat, ist eine Behauptung, kein Nachweis.
- QueryChart erzeugt das automatisch über sein Änderungsprotokoll, siehe /features/version-control.
Die Tabelle ist ein Nachweis, keine Disziplin
Eine Änderungshistorie ist die Tabelle, die sich die meisten Leser sofort vorstellen: eine Versionsnummer, ein Datum, der Name der Person, die die Änderung vorgenommen hat, eine kurze Beschreibung dessen, was sich geändert hat, und oft der Name desjenigen, der es geprüft hat. Es ist ein Artefakt: Zeilen in einer Tabelle, üblicherweise auf der Titelseite des Dokuments selbst. Versionskontrolle ist die andere Sache, die diese Zeilen erzeugt: die Praxis, ein gelenktes Dokument niemals zu bearbeiten, ohne einen Eintrag zu schreiben, einen Eintrag nie im Nachhinein umzuschreiben, und jemand anderen als den Bearbeiter den Eintrag gegen die Bearbeitung prüfen zu lassen. Ein Dokument kann eine vollständig aussehende Änderungshistorie tragen und trotzdem keine echte Versionskontrolle dahinter haben, wenn nie jemand eine einzige Zeile gegen die tatsächliche Änderung geprüft hat.
Behandeln Sie die Änderungshistorie als eigenständiges Objekt, getrennt vom Dokument, das sie beschreibt, nicht als Abschnitt darin. Das Dokument ändert sich; das Protokoll wächst nur. Jeder Eintrag braucht eine Versionsnummer, ein Datum, einen Autor, eine allgemeinverständliche Beschreibung dessen, was sich geändert hat und warum, einen Verweis auf die abgelöste Version und (die Spalte, die die meisten selbst gebauten Tabellen auslassen) wer den Eintrag gegen die tatsächliche Bearbeitung verifiziert hat. Lassen Sie diese letzte Spalte weg, und das Protokoll ist eine Sammlung ungeprüfter Behauptungen: die Darstellung eines Autors über seine eigene Änderung, abgelegt von derselben Person, die sie vorgenommen hat.
Das Diagramm unten durchläuft einen generischen Prozess für Änderungsprotokoll-Einträge (sechzehn Zeilen über fünf Bahnen), bei dem das, was durch den Prozess läuft, der Protokolleintrag selbst ist, nicht das Dokument. Ein Antrag eröffnet einen offenen Eintrag, ein Autor setzt die Änderung um und reicht eine Vorher-Nachher-Beschreibung ein, ein Prüfer gleicht diese Beschreibung mit der tatsächlichen Bearbeitung ab, bevor irgendetwas geschlossen wird, und ein Auditor prüft geschlossene Einträge später stichprobenartig. Dieser Vergleichsschritt ist das, was einer selbst gebauten Tabellenkalkulation fast nie hat, weil niemand explizit dafür zuständig ist, ihn auszuführen. QueryChart ersetzt die selbst gebaute Tabelle vollständig: Jede Bearbeitung eines Diagramms wird in einem Änderungsprotokoll mit Vorher-Nachher-Werten je Feld und dem Namen des Bearbeiters erfasst, einsehbar in einer Ansicht zum Versionsvergleich, unter /features/version-control: niemand muss den Eintrag eintippen, denn er ist der Nachweis dessen, was tatsächlich bearbeitet wurde, keine Selbstauskunft.
Sechzehn Zeilen, fünf Bahnen, ein Protokolleintrag
Verfolgen Sie, wie ein einzelner Änderungsprotokoll-Eintrag vom Antrag bis zu einem verifizierten, im Audit stichprobengeprüften Abschluss läuft: die Spalten, die eine selbst gebaute Tabelle üblicherweise auslässt, als Prozess dargestellt.
Ein Antrag, noch kein Eintrag
Die Start-Zeile ist „Änderung an einem gelenkten Dokument beantragt“ (ein Ereignis, keine Aufgabe), gefolgt von „Änderungsantrag mit Begründung und Zieldokument einreichen“, das das genaue Dokument und die Begründung benennt, bevor überhaupt etwas protokolliert wird. „Änderung zur Protokollierung freigegeben?“ entscheidet, ob überhaupt ein offener Eintrag eröffnet wird.
Der Eintrag öffnet, bevor die Bearbeitung beginnt
Erst nach der Freigabe erscheint „Offenen Protokolleintrag anlegen“, als Datei-Zeile statt als Notiz in jemandes Posteingang. „Eintragsnummer vergeben und Dokument verknüpfen“ und „Änderung einem Autor zuweisen“ geschehen beide in der Bahn des Protokollverantwortlichen, bevor die Bahn des Autors beginnt: der Eintrag existiert als Nachweis, bevor auch nur ein Wort des Dokuments sich ändert.
Verifizierung, nicht nur eine Beschreibung
„Änderung im Dokument umsetzen“ verschiebt die Arbeit in die Bahn des Autors, und „Vorher-Nachher-Beschreibung, Autor und Datum festhalten“ wird als eigene Zeile abgelegt, statt in die Bearbeitung eingefaltet zu werden. „Protokolleintrag mit umgesetzter Änderung abgleichen“ und „Gegen das Dokument verifiziert?“ verlangen dann vom Prüfer, die Worte des Eintrags gegen die tatsächliche Bearbeitung zu prüfen, bevor irgendjemand beidem vertraut.
Eine Abweichung, dann Abschluss und Audit
„Abweichung im Dokument oder im Protokolleintrag?“ schickt eine gescheiterte Prüfung zurück zu „Änderung im Dokument umsetzen“ oder „Vorher-Nachher-Beschreibung, Autor und Datum festhalten“, je nachdem, was falsch war. Ein verifizierter Eintrag erreicht „Protokolleintrag schließen“, „Antragsteller über den Abschluss der Änderung informieren“ und „Geschlossene Einträge im periodischen Audit stichprobenartig prüfen“ vor dem Ende, „Änderungsprotokoll-Eintrag geschlossen und auditbereit“, mit „Antrag abgelehnt, nicht protokolliert“ als dem anderen Ausgang, oben am Anfang.
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äufige Fehler
Das Protokoll als Gedächtnistest
Den Eintrag Tage nach der Bearbeitung zu schreiben macht aus einem Nachweis eine Rekonstruktion. Öffnen Sie den offenen Eintrag, sobald die Änderung freigegeben ist, und legen Sie die Vorher-Nachher-Beschreibung am selben Tag ab, an dem die Bearbeitung erfolgt, nicht aus dem, woran sich jemand Wochen später erinnert.
Historie an Ort und Stelle bearbeiten
Zeile drei einer Tabellenkalkulation zu korrigieren, um eine falsche Beschreibung zu reparieren, zerstört genau das, wofür eine Änderungshistorie existiert: den Nachweis, was wann erfasst wurde. Hängen Sie stattdessen eine neue Zeile an; /de/guides/aenderungen-in-einer-sop-nachverfolgen und /de/guides/sop-revisionen-verwalten behandeln diese Nur-wachsend-Disziplin speziell für SOPs.
Ein Protokoll, das niemand gegen das Dokument prüft
Eine Tabelle mit einer Spalte Version und Beschreibung, aber ohne Verifizierungsschritt, ist eine Sammlung von Behauptungen, kein Nachweis. Geben Sie dem Vergleich eine eigene Zeile mit einem eigenen Verantwortlichen, wie „Protokolleintrag mit umgesetzter Änderung abgleichen“ es im Diagramm oben tut, sonst ist das Protokoll nur so verlässlich wie das Gedächtnis des Autors.
Das Protokoll mit dem Prozess verwechseln, der es erzeugt
Eine Änderungshistorie erfasst, was sich geändert hat; sie entscheidet nicht, wer eine Änderung freigeben darf oder wo abgelöste Exemplare liegen: das ist Dokumentenlenkung, vollständig behandelt unter /de/templates/dokumentenlenkung-prozess. Bauen Sie beides, aber halten Sie sie als getrennte Artefakte.
Bauen Sie Ihr eigenes Änderungsprotokoll
Öffnen Sie das Diagramm zum Protokolleintrag-Prozess als eigene Vorlage, setzen Sie Ihre eigenen Dokumenttypen in die Bahnen, und lassen Sie das Änderungsprotokoll von QueryChart die verifizierte Historie führen statt einer Tabellenkalkulation.
Verwandte Anleitungen
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.
