August 2, 2026 · 2 Min. Lesezeit
In meinem aktuellen Programm habe ich mehr als siebenundvierzig Arbeitsanweisungen von null geschrieben. Nicht verbessert, nicht zusammengeführt — geschrieben, weil es keine gab.
Das meiste, was ich heute über Dokumentation denke, habe ich gelernt, indem ich es bei den ersten zehn falsch gemacht habe.
Die ersten Dokumente, die ich geschrieben habe, waren korrekt. Sie beschrieben, was die Plattform tut, welche Randbedingungen gelten und was eine kompetente Betriebsperson damit tun sollte. Sie waren trotzdem nahezu nutzlos — und ich habe es erst gemerkt, als jemand in einem anderen Land versuchte, damit zu arbeiten.
Sie waren korrekt für mich. Jedes einzelne hatte eine Lücke, die mein eigenes Wissen stillschweigend gefüllt hat: ein angenommener Standardwert, eine unbenannte Voraussetzung, ein Schritt, der nur Sinn ergibt, wenn man ohnehin weiß, warum es ihn gibt. Ich konnte die Lücken nicht sehen, weil ich das Einzige war, was sie unsichtbar machte.
Genau das ist der Unterschied zwischen einem Artefakt und einer Schnittstelle. Ein Artefakt hält fest, was man weiß. Eine Schnittstelle kann eine andere Person ohne einen bedienen. Nur eines davon ist die Schreibzeit wert.
Die Regel, bei der ich gelandet bin, ist schlicht: Kann jemand in einem anderen Land dem hier folgen, ohne mich zu fragen?
Das entscheidende Wort ist beim. Am Ende angewendet, erzeugt dieser Test einen Review-Kommentar. Während des Schreibens angewendet, verändert er, was man schreibt — man hört auf zu beschreiben und fängt an anzuleiten, weil man sich eine konkrete Person vorstellt, die keine Rückfrage stellen kann und in einer anderen Zeitzone sitzt.
Was den Test nicht bestand, wurde neu geschrieben. Nicht kommentiert, nicht ergänzt. Eine Anweisung mit einer angehängten Klarstellung ist eine Anweisung, die erneut missverstanden wird — nur an anderer Stelle.
Die Ökonomie ist unsymmetrisch. Eine Lücke, die man beim Schreiben findet, kostet einen Absatz. Dieselbe Lücke, die ein Audit findet, kostet eine Feststellung, eine Nachbesserung und ein Gespräch darüber, ob das Betriebsmodell echt ist.
Dazu kommt ein subtilerer Preis. Dokumentation, die zum Ablegen geschrieben wurde, liest sich anders als Dokumentation, die zum Benutzen geschrieben wurde — und Betriebsteams merken innerhalb einer Seite, welche Sorte sie in der Hand halten. Die erste lehrt sie still, dass Antworten nicht in Dokumenten stehen. Glaubt ein Team das erst einmal, fragt es wieder Menschen — also genau die Abhängigkeit, die die Dokumente beseitigen sollten.
Der Maßstab, dem ich traue, ist nicht die Anzahl der Dokumente. Es ist, ob die übernehmende Organisation die darauf aufgebauten Schulungen abgenommen hat — in diesem Fall in allen drei Ländern — und die Plattform danach ohne mich betrieben hat.
Alles davor ist eine Hypothese. Siebenundvierzig Anweisungen, denen noch niemand gefolgt ist, sind siebenundvierzig Hypothesen mit Versionsnummer.
Schreibe für die Person, die kommt, wenn du weg bist. Nicht aus Höflichkeit — als Konstruktionsprinzip.
Sie ist die einzige Leserin, deren Erfahrung du nicht dadurch reparieren kannst, dass du verfügbar bist. Und in einem Programm, das übergeben werden soll, war sie immer die einzige, auf die es ankam.
