ET-DOC-ARCH-001

Documentation Tooling Architecture#

Zweck#

Documentation Tooling überführt versionierte Quellen reproduzierbar in lesbare Dokumentation und , ohne fachliche Inhalte stillschweigend umzudeuten.

Verarbeitungskette#

führende versionierte Quellen
                → Struktur- und Metadatenprüfung
                → Referenz- und Linkauflösung
                → optionale Materialisierung
                → Rendering oder Reportableitung
                → Validierung
                → Veröffentlichung außerhalb der führenden Quellen

Verantwortungen#

Quellen in ihrer bestehenden Identität und Reihenfolge lesen,
Navigation und Referenzen deterministisch auflösen,
Render- und Reportausgaben nachvollziehbar ableiten,
Warnungen und Fehler als ausgeben,
Quell- und Ausgabepfade klar trennen.

Nicht verantwortlich#

fachliche Architekturentscheidungen,
stillschweigende Korrektur widersprüchlicher Inhalte,
produktive Laufzeitdaten,
ungeprüfter generierter Ausgaben,
Ersetzung führender Markdown-Quellen durch HTML oder Reports.

Sicherheitsgrenzen#

Ausgaben dürfen Quellen nicht ohne ausdrücklichen Schreibmodus überschreiben. Pfadtraversal, absolute Zielpfade außerhalb freigegebener Wurzeln und unkontrolliertes Nachladen externer Inhalte sind abzulehnen.