Hauptgedanke

Spezifikation, Support-Dokumentation und Rahmendokument werden oft mit ihrer Klarheit verteidigt: Alle verstehen sie, man kann sie in Meetings nutzen, mit den Teams teilen und ohne technische Kompetenz verwenden. Diese Qualitäten sind echt, aber es sind Qualitäten des Zugangs, keine Qualitäten der Information.

Der Grund für diese Schicht ist eine Einschränkung bei der Leserschaft: die meisten Product Manager, Vertriebsleute und Support-Mitarbeiter arbeiten nicht im Repository. Es brauchte also ein Zwischenobjekt, weniger verlässlich als der Code, aber lesbar für diejenigen, die entscheiden. Solange diese Einschränkung galt, war die Schicht in natürlicher Sprache die am wenigsten schlechte verfügbare Lösung — und niemand musste zwischen Verlässlichkeit und Lesbarkeit wählen, weil nur eine der beiden erreichbar war.

Daraus folgt: An dem Tag, an dem der Zugang zur Quelle nicht mehr denen vorbehalten ist, die sie lesen können, entfällt das Argument, das die Schicht rechtfertigte — die Schicht selbst aber bleibt bestehen.

Warum das wichtig ist

Das verhindert, die allmähliche Aufgabe der Dokumentation als Nachlässigkeit zu lesen. Die Schicht wurde nicht um ihrer selbst willen verteidigt, sie glich einen fehlenden Zugang aus; wird der Ausgleich verzichtbar, verliert das Artefakt seine Grundlage, ohne dass es jemand beschlossen hätte.

Es liefert auch einen Test, den man auf jedes Zwischendokument anwenden kann: Welchen fehlenden Zugang gleicht es aus? Lautet die Antwort „keinen“, dupliziert es eine Information, die anderswo besser gepflegt existiert.

Nuancen und Grenzen

Zugang ist nicht alles. Ein Dokument in natürlicher Sprache enthält auch die Absicht und den fachlichen Kontext, die das Repository nicht enthält — dieser Teil verschwindet nicht, wenn die Zugangsbarriere fällt.

Und den Code über ein Werkzeug lesen zu können heißt nicht, ihn zu verstehen: Die Barriere verschiebt sich zur technischen Kultur, statt zu verschwinden.

Offene Fragen

• Wer stellt fest, dass ein Dokument in natürlicher Sprache keine Leser mehr hat, wenn seine Erstellung im Prozess festgeschrieben bleibt?