Derselbe Wunsch, zweimal formuliert
Ein echter Fall aus der Arbeit an dieser Umgebung — einmal so, wie man es zuruft, und einmal so, dass es abnehmbar ist. Mit dem, was jeweils herauskommt.
Die vier Angaben klingen nach Bürokratie, solange man sie nicht nebeneinander gesehen hat. Also: derselbe Wunsch, zweimal.
Mach die Prüfliste im Handbuch besser.
Was zurückkommt: eine überarbeitete Prüfliste — mit vierzehn statt sieben Punkten, neu gegliedert, in freundlicherem Ton, und mit drei Punkten, die auf Dinge verweisen, die es in dieser Umgebung nicht gibt.
Warum: „Besser" ist keine Eigenschaft, sondern eine Richtung. Ohne Ziel wählt das Werkzeug die naheliegendste Auslegung — und die naheliegendste Auslegung von „besser" ist „mehr".
Ziel: Jeder Punkt der Prüfliste in handbuch/3-sichern.md ist von außen entscheidbar — jemand, der das Projekt nicht kennt, kann Haken setzen, ohne zu fragen. Gegeben: Die sieben Punkte stehen schon da und decken den richtigen Stoff ab. Es geht um die Formulierung, nicht um den Umfang. Tabu: Keine neuen Punkte, keine Umgliederung, keine Änderung an anderen Dateien des Handbuchs. Nachweis: Zu jedem Punkt steht dahinter in Klammern, womit man ihn prüft — ein Befehl, eine Datei oder eine Stelle in der Oberfläche.
Was zurückkommt: dieselben sieben Punkte, umformuliert, jeder mit seiner Prüfstelle. Zwei Punkte kommen mit einer Rückfrage zurück, weil sich für sie keine Prüfstelle finden ließ — das ist das wertvollste Ergebnis des ganzen Auftrags.
Was der Vergleich zeigt
| Zugerufen | Abnehmbar formuliert | |
|---|---|---|
| Aufwand beim Schreiben | zehn Sekunden | zwei Minuten |
| Aufwand beim Prüfen | die Liste ganz neu lesen | sieben Klammern nachsehen |
| Was Sie danach wissen | dass etwas anders ist | dass jeder Punkt prüfbar ist — und welche zwei es nicht waren |
| Was passiert, wenn es nicht passt | noch einmal von vorn | ein Satz, gezielt |