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.
August 2026

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.

Kategorien:
1Automatisierung und CI/CD	/de/categories/automation/	engineer.company	70
1Tests und Qualitätssicherung	/de/categories/testing/	engineer.company	70
1Python	/de/categories/python/	engineer.company	70
1Technische Leitung	/de/categories/technical-leadership/	engineer.company	70
1Projektmanagement	/de/categories/project-management/	engineer.company	70
1Dokumentation	/de/categories/documentation/	engineer.company	70

Leistungen:
1Technische Leitung und Beratung	/de/services/technical-leadership/	engineer.company	70
1Projektmanagement (Agile)	/de/services/project-management/	engineer.company	70
1Technische Dokumentation	/de/services/technical-documentation/	engineer.company	70

hDiese Seite im Web	URL:https://engineer.company/de/portfolio/put-the-documentation-under-its-own-linter/	engineer.company	70
