Ursprünglich auf Französisch verfasst. Von KI übersetzt — der Sinn wurde bewahrt, nicht der Stil.
Hauptgedanke
Jeder Steckbrief eines Produkt-Referenzwerks führt ein Protokoll, in das man Einträge hinzufügt, ohne je die vorherigen zu korrigieren. Ein Eintrag, der eine Code-Version nennt, zeigt an, dass sich das Produkt geändert hat. Ein Eintrag ohne Code-Version zeigt etwas anderes an: Dann hat sich unser Verständnis geändert, nicht die Software.
Beim Schreiben wirkt die Unterscheidung nebensächlich. Sie ist es aber, die es sechs Monate später erlaubt, eine Frage zu beantworten, die sich auf keinem anderen Weg klären lässt: Haben wir einen Steckbrief korrigiert, oder hat sich das Produkt weiterentwickelt? Ohne sie verschwimmen beide Bewegungen in ein und demselben „aktualisiert am“.
Der Pflegemechanismus hängt daran: Die Referenzversion dient als Bezugspunkt und liefert mit einem einzigen Befehl die Liste dessen, was sich im Produkt seit der letzten Aktualisierung bewegt hat — also die Liste dessen, was noch festzuhalten ist.
Warum das wichtig ist
Das trennt zwei Arten des Veraltens, die unterschiedliche Handgriffe verlangen. Ein Steckbrief, der dem Produkt hinterherhinkt, wird mechanisch nachgezogen, indem man die Quellen der neuen Version liest. Ein Steckbrief, der korrigiert wurde, weil man etwas falsch verstanden hatte, wirft eine Frage auf: Was hatte uns getäuscht, und ist diese Ursache verschwunden?
Es erlaubt auch, die Verlässlichkeit einer Beschreibung zu beurteilen: Ein Steckbrief, dessen Protokoll nur Korrekturen des Verständnisses enthält, wurde zu schnell geschrieben.
Nuancen und Grenzen
Der Mechanismus setzt voraus, dass sich eine Version des Produkts zitieren lässt — ein Repository, eine Release-Nummer. Bei einem System ohne klare versionierte Referenz wird die Unterscheidung zur bloßen Behauptung und nutzt sich ab.
Und das nur ergänzte Protokoll wächst ohne Grenze: Ab einem gewissen Umfang muss man wissen, was man damit anfängt, und dieses Problem löst die vorliegende Notiz nicht.
Offene Fragen
- In welchem Takt aktualisiert man die Referenzversion, wenn jeder Aufschub die Liste dessen verlängert, was dann auf einen Schlag festzuhalten ist?