Abgleich Von Demo Und Spezifikation
Der Abgleich von Demo und Spezifikation ist die Praxis, das Verhalten von Prototyp oder Demo mit der dokumentierten Produktabsicht konsistent zu halten und die Spezifikation ausdrücklich zu aktualisieren, wenn eine Demo einen besseren Ablauf zeigt.
Warum das wichtig ist
Demos sind nützlich, weil sie Arbeitsabläufe konkret machen. Sie sind riskant, weil sichtbares Verhalten oft als genehmigte Produktwahrheit behandelt wird, obwohl die zugrunde liegende Dokumentation nie aktualisiert wurde.
Empfohlene Autoritätsreihenfolge
- Produktspezifikation
- Implementierungsleitlinien
- Dokumentation des aktuellen Zustands
- Demo- oder Implementierungsverhalten
- Validierung und Tests
Diese Reihenfolge bedeutet nicht, dass Demos unwichtig sind. Sie bedeutet, dass Demos innerhalb eines dokumentierten Entscheidungssystems interpretiert werden sollten.
Gesunde Nutzung von Demos
Nutzen Sie Demos, um:
- Probleme in Abläufen sichtbar zu machen
- Nutzbarkeitsprobleme aufzudecken
- Annahmen mit Nutzern zu testen
- Erklärungen für Stakeholder zu unterstützen
Verwenden Sie Demos nicht als stillen Ersatz für Produktentscheidungen.
Wann die Demo führen sollte
Wenn die Demo einen klar besseren Ablauf zeigt, sollte das Team:
- die Änderung bewusst prüfen
- die relevante Spezifikation und Dokumentation aktualisieren
- Validierungs- oder Review-Erwartungen anpassen
Mit anderen Worten: Die Demo kann die nächste Entscheidung auslösen, aber die aktualisierte Entscheidung sollte weiterhin dokumentiert werden.
Let-Books-Kontext
Das Let-Books-Repository unterscheidet bereits zwischen kanonischer Dokumentationsevidenz und Implementierungsstatus für öffentliche Texte. Das ist eine nützliche Leitplanke, weil Prototypen so nicht versehentlich redaktionelle Autorität bekommen.