Dokumentation einem eigenen Linter unterstellt
Die Dokumentation einem eigenen Linter unterstellt — mit nur absenkbarem Zeilenbudget je Datei, Inhaltsverzeichnispflicht und Prüfung echter Pfade — der sechs von neun als erledigt markierte Pläne mit offenen Aufgaben und vierzehn in keinem Dokument genannte verpflichtende Commit‑Prüfungen fand.
Ausgeführt: August 2026
die Dokumentation unter einen eigenen Linter gestellt
Situation. Das Repository steuert sich über schriftliche Anweisungen: sechsundzwanzig Dokumente zu Qualität, Designsystem, Barrierefreiheit, Druck, Metadaten, Übersetzung und Git. Solche Anweisungen verfallen nach einem typischen Muster: Sie werden länger, weichen vom Code ab, verweisen auf verschobene Dateien und werden ab einer bestimmten Größe nicht mehr gelesen. Eine ungelesene Regel ist keine Regel.
Aufgabe. Die Dokumentation brauchte dieselbe Behandlung wie Code: einen Linter mit verbindlich scheiternden Grenzen statt Empfehlungen.
Massnahmen. Acht Richtlinien wurden mechanisch prüfbar. Eine harte Längenobergrenze und eine weichere Warnschwelle. Ein nur absenkbares Zeilenbudget je Datei, damit geschrumpfte Dokumente nicht wieder wachsen. Inhaltsverzeichnisse und bei geringerer Schwelle Abschnittsindizes. Eine Zuständigkeitsregel für Themenorte. Gültige Links. Ehrliche Planstände entsprechend den eigenen Aufgabenlisten. Die Benennung jeder commitblockierenden Aufgabe in mindestens einem Dokument. Und die Existenz jedes verzeichnisqualifizierten Pfads und jedes benannten Codesymbols. Bereits der erste Lauf begründete die ganze Arbeit: sechs als erledigt bezeichnete Pläne mit offenen Kästchen, vierzehn undokumentierte Commit‑Prüfungen, drei tote Links, ein verwaistes Dokument und drei tote Pfade in fünf Dokumenten. Anschließend wies das Budget den eigenen Autor zurück: Die Zusammenfassung dieser Arbeit überschritt die Grenze des Entwicklungsdokuments. Deshalb entstand ein separates Dokument — genau die beabsichtigte Wirkung der Richtlinie.
Ergebnis. Sechsundzwanzig Dokumente mit etwa 2.666 effektiven Zeilen stehen jeweils unter einem nicht erhöhbaren Budget. Alle benannten Pfade und Symbole werden gegen den Dateibaum geprüft. Der unbequeme Kernbefund bleibt: Vierzehn Prüfungen blockierten jeden Commit, standen aber in keinem Dokument. Maschinenregeln und von Menschen gelesene Regeln waren bereits auseinandergefallen.

Foto: Mohamed_hassan / Pixabay 
Foto: Tomasz_Mikolajczyk / Pixabay
Diese Erfahrung für Ihr Projekt nutzen
Nutzen Sie „Dokumentation einem eigenen Linter unterstellt“ als Ausgangspunkt für eine ähnliche Herausforderung in Ihrer Organisation. Die Leistungen hinter dieser Arbeit stehen auch für Ihr Projekt zur Verfügung. Jemand sitzt auf Ihrer Seite des Tisches, wenn eine Lieferanten-, Budget- oder Architekturentscheidung eine zweite fundierte Meinung braucht.
Hinter das Ergebnis schauen
Lesen Sie die Situation, die Entscheidungen und das Ergebnis dieses Beispiels. Wir können besprechen, welche Teile sich auf Ihre Rahmenbedingungen übertragen lassen und welche einen anderen Ansatz erfordern. Dokumentation einem eigenen Linter unterstellt — die Dokumentation unter einen eigenen Linter gestellt
Zurückblicken auf Entwicklung in 51 schriftlichen Vorhaben geführt. Oder entdecken Sie das gesamte Portfolio.
Ein Teil einer längeren Arbeitsbilanz — vollständig auf dieser Website zu finden.
Jeder Eintrag folgt demselben Aufbau: die Situation, die Aufgabe, unser Vorgehen und die Veränderungen.

