Zum Inhalt
wannacode

Eine Spezifikation prüfen

Kurz gesagt: Eine Spezifikation wird zweimal gelesen: einmal ganz, dann Zeile für Zeile mit einer Checkliste. Befunde stehen im Text (Wörter ohne Maß, Mehrdeutigkeiten, Widersprüche) und außerhalb davon (Fälle, zu denen der Text schweigt). Jeder wird mit Stelle, Art, Schweregrad und einem Vorschlag erfasst. Am Ende bekommt jeder eine Entscheidung: korrigieren, Frage an den Inhaber oder kein Problem.

Problem

Zwei Wochen vor dem Start

Die Gutscheincodes gehen in zwei Wochen live. Die Analystin hat die Spezifikation geschrieben und schickt sie dir und zwei anderen zum Review. Die Frist ist morgen um 14:00 Uhr, die Besprechung am Freitag.

Du bist Reviewer. Du hast die Checkliste aus der vorigen Lektion, die Spezifikation und eine Stunde. Das Ziel ist klar: so viele Probleme finden, wie du kannst, jetzt, solange jedes ein Wort kostet.

Die Idee

Wie man liest

Die Spezifikation wird zweimal gelesen.

Zuerst als Ganzes, ohne anzuhalten. Die Frage lautet „Was fehlt?“. Eine Regel, von der kein Satz spricht, ist unsichtbar, wenn du Zeile für Zeile liest.

Dann Zeile für Zeile, mit der Checkliste. Für jeden Satz: wer; gibt es ein Maß; was passiert an der Grenze und im negativen Fall; sagt er, was, nicht wie; widerspricht er etwas.

Schreib sofort auf, mit der Stelle. „P-3, ‚einmal‘: pro Kunde oder pro Bestellung?“ In einer Stunde erinnerst du dich nicht, welche Zeile es war.

Probier es aus

Die Spezifikation: die Regeln

Der erste Teil der Spezifikation. Markiere die Probleme und wähle die Art jedes einzelnen.

Klicke auf die Wörter, die ein Problem sind; noch einmal, um die Markierung zu entfernen. Mit den Pfeiltasten geht es von Wort zu Wort.

Probier es aus

Die Spezifikation: die Rabatte

Der zweite Teil und eine Anforderung aus der Spezifikation der Treue. Markiere die Probleme und wähle die Art jedes einzelnen.

Klicke auf die Wörter, die ein Problem sind; noch einmal, um die Markierung zu entfernen. Mit den Pfeiltasten geht es von Wort zu Wort.

Die Idee

Was nicht da ist

Das zweite Lesen findet die Wörter. Das erste findet die Lücken, und sie sind oft ernster. In der Spezifikation der Gutscheincodes:

  • Der zweite Versuch. P-3 sagt, der Code wird einmal verwendet, aber was sieht der Kunde, wenn er es noch einmal versucht? Die Regel lautet „Der Code wurde bereits verwendet“. Im Text steht sie nicht.
  • Die stornierte Bestellung. Die Bestellung mit dem Code wird vor dem Versand storniert. Ist der Code verbraucht? Die Regel sagt „in einer bezahlten Bestellung“. Ob er nach einer Stornierung verbraucht bleibt, hat niemand gesagt. Das ist eine Frage an den Inhaber.
  • Die Rückgabe. Der Kunde gibt ein mit Rabatt gekauftes Produkt zurück. Wird ihm mit oder ohne Rabatt erstattet? Noch eine Frage.
  • Wer die Codes anlegt. Wer legt sie an, und wer setzt die Frist? Will die Buchhaltung wissen, wie viel Rabatt gegeben wurde?

Keinen dieser Befunde kann man als Wort markieren. Sie werden gesondert erfasst, mit der Stelle „fehlt“.

Die Idee

Das Review-Protokoll

Ein Befund, der nicht aufgeschrieben ist, existiert nicht. Das Review-Protokoll ist eine Tabelle, nach der der Autor korrigiert, ohne dich zu fragen.

# Stelle Befund Art Schweregrad Vorschlag
1 P-6, L-2 „addieren sich“ gegen „der größere gilt“ widersprüchlich hoch P-6: „der größere gilt“
2 P-1 10 % wovon: den Produkten oder auch der Lieferung? mehrdeutig hoch Frage an den Inhaber
3 P-3 „einmal“: pro Kunde oder pro Bestellung? mehrdeutig hoch „in einer bezahlten Bestellung“
4 fehlt was der Kunde bei einem zweiten Versuch sieht unvollständig mittel „Der Code wurde bereits verwendet“
5 fehlt ist der Code nach einer stornierten Bestellung verbraucht unvollständig mittel Frage an den Inhaber
6 P-5 „in einem Pop-up-Fenster“ Lösung statt Bedarf niedrig entfernen
  • Die Stelle sagt, wo. Die Nummer der Anforderung ist besser als „nahe am Anfang“.
  • Die Art sagt, was falsch ist, mit den Wörtern aus der Lektion „Die gute Anforderung“.
  • Der Schweregrad sagt, wie sehr es wehtut, wenn der Fehler den Kunden erreicht. „Die Rabatte addieren sich“ tut bei jeder Bestellung mit Geld weh. „Pop-up-Fenster“ tut kaum weh.
  • Der Vorschlag ist kein Befehl. Er zeigt, dass du das Problem verstanden hast, und gibt dem Autor einen Ausgangspunkt.

Das Protokoll hat keinen Namen des Autors. Geprüft wird das Dokument.

Genauer, für Neugierige

Der Schweregrad in einem Review ist derselbe Gedanke wie der Schweregrad eines Fehlers, dem du im Modul über den Prozess begegnest: wie ernst die Folgen sind. Die Priorität (wann es korrigiert wird) ist eine eigene Entscheidung. Teams benutzen oft wenige Stufen: blockierend, hoch, mittel, niedrig.

Inspektionen erheben aus dem Protokoll auch Kennzahlen: wie viele Befunde pro Seite, von welcher Art, wie viel Zeit hineinging. So sieht das Team zum Beispiel, dass „fehlender negativer Fall“ der häufigste Befund ist, und ergänzt die Checkliste um eine Frage dazu.

Probier es aus

Die gute Erfassung

1. Welche Erfassung eines Befunds ist nützlich?
2. Welchen Schweregrad hat der Befund zu P-6 („die Rabatte addieren sich“)?
3. Welchen Schweregrad hat der Befund „in einem Pop-up-Fenster“?
4. Warum hat die Erfassung einen Vorschlag und nicht nur das Problem?

Die Idee

Die Besprechung und die Entscheidung

Am Freitag werden die Befunde der drei Reviewer zusammengelegt. Der Moderator geht sie einzeln durch. Jeder bekommt eine Entscheidung:

  • korrigieren: Das Problem ist klar, die Regel ist klar, der Autor korrigiert;
  • Frage an den Inhaber: Die Regel gibt es nicht, und niemand im Raum kann sie erfinden;
  • kein Fehler: Die Diskussion zeigt, dass der Text in Ordnung ist; der Grund wird festgehalten, damit er nicht wieder auftaucht.

Am Ende bekommt auch das Dokument eine Entscheidung: angenommen, angenommen nach den Korrekturen oder braucht ein neues Review. Mit einer offenen Frage zum Preis kann die Arbeit an der Story nicht beginnen. Also geht die Spezifikation der Gutscheincodes zurück, bis der Inhaber sagt, wovon die 10 Prozent berechnet werden.

Übung

Was mit dem Befund geschieht

1. Die Entscheidung. Wähle für jeden Befund aus der Besprechung, was mit ihm geschieht.

1. Der Befund: „10 % Rabatt: von den Preisen der Produkte oder von der ganzen Summe mit Lieferung?“ Was geschieht mit ihm?
2. Der Befund: „P-6 und L-2 widersprechen sich.“ Die Regel des Shops ist klar: Der größere gilt. Was geschieht?
3. Ein Reviewer schreibt: „Ich schlage vor, den Code in Großbuchstaben einzugeben.“ Die Diskussion zeigt, dass niemand das verlangt hat. Was geschieht?
4. Nach der Diskussion gibt es zwei Befunde mit hohem Schweregrad und eine offene Frage. Wie lautet die Entscheidung zum Dokument?

Test

Teste dich

1. Warum wird die Spezifikation zweimal gelesen?
2. Was lässt sich nicht als Wort im Text markieren?
3. Was soll jede Erfassung eines Befunds enthalten?
4. Wer entscheidet, was mit einer offenen Frage zu einer Regel geschieht?

Erstellt von Ivo Gergov im Rahmen der Kampagne von Evo Tech für zugängliche Programmierausbildung ·