Eine Code-Review-Aussage genau dem geänderten Verhalten zuordnen, das sie belegt

Ziel

Eine kompakte Review-Karte erstellen, die verhindert, dass sachfremde bestandene Prüfungen als Beleg für ein neu geändertes Verhalten herangezogen werden.

Voraussetzungen

Den endgültigen Diff, die Abnahmekriterien und abgeschlossene Validierungsergebnisse vorliegen haben. Beobachtete Ergebnisse von geplanten Prüfungen trennen und Verweise auf Nachweise so knapp halten, dass eine überprüfende Person sie einsehen kann.

Schritte

1. Die Verhaltensänderungen auflisten, nicht nur die betroffenen Dateien. Eine Konfigurationsänderung kann Start, Autorisierung oder Anfrage-Routing betreffen; jede folgenreiche Änderung braucht eine ausdrückliche Aussage.

2. Für jedes Verhalten die Prüfung bestimmen, die das beabsichtigte Ergebnis vom vorherigen oder einem plausiblen falschen Ergebnis unterscheiden würde. Die tatsächlich durchgeführte Prüfung und die von ihr abgedeckte Artefaktrevision verlinken.

3. Nachweise als direkt, indirekt oder fehlend markieren. Ein erfolgreicher Build kann die Kompilierbarkeit belegen, während das Routing zur Laufzeit ungeklärt bleibt; ein Ergebnis nicht über das hinaus strecken, was seine Beobachtung tatsächlich belegt hat.

4. Lücken prüfen und die kleinste zulässige zusätzliche Prüfung wählen, die sie schliesst. Braucht eine Prüfung nicht verfügbare Infrastruktur, die fehlende Voraussetzung benennen und die Aussage eingeschränkt halten.

5. Die Karte aus der Perspektive einer Person prüfen, die das Gespräch nicht gesehen hat. Sie bitten, das Verhalten zu finden, die betreffende Prüfung nachzuvollziehen und zu erklären, was zu ihrem Scheitern führen würde.

Erwartetes Ergebnis

Die Review-Beschreibung verknüpft jede wesentliche Änderung mit angemessen abgegrenzten Nachweisen und jeder verbleibenden Unsicherheit. Überprüfende Personen können ihren Aufwand auf unbelegtes Verhalten konzentrieren, statt ein chronologisches Aktivitätsprotokoll erneut zu lesen.

Grenzen und Prüfbasis

Dies ist eine eigene Review-Technik und keine gemessene Verbesserung der Fehlererkennung. Eine gut organisierte Karte kann weiterhin schwache Prüfungen oder ein unvollständiges Verhaltensinventar enthalten. Für diesen Artikel wurde kein Review-Experiment durchgeführt.