README
Dokumentation#
Zweck#
Produkt- und Entwicklerdokumentation der Engineering Platform.
Verantwortlichkeit#
Dieser Bereich verantwortet ausschließlich die unter „Zweck“ beschriebene Sicht innerhalb von engineering-platform.
Inhalt#
- Freigegebene Quellen und Modelle dieses Verantwortungsbereichs.
- Navigation und Querverweise zu abhängigen Artefakten.
- Arbeitsdokumente nur dann, wenn sie bewusst bei diesem fachlichen Eigentümer geführt werden.
Gehört ausdrücklich nicht hier hinein#
- Veränderliche Laufzeitzustände oder generierte Betriebsausgaben.
- Inhalte, deren höchste allgemeingültige Ebene in einem anderen Repository liegt.
- Unkontrollierte Duplikate bereits führender Quellen.
Beziehungen#
- Ist Bestandteil von
engineering-platform. - Wird durch Contract, Baselines und ADRs eingeordnet.
- Kann durch
engineering-toolsvalidiert, materialisiert oder paketiert werden.
Typischer Workflow#
Inhalte werden innerhalb des beauftragten Scopes erstellt oder geändert, gegen führende Quellen validiert und erst danach promoted.
Langfristige Entwicklung#
Der Bereich wird schrittweise mit realen Artefakten gefüllt; seine Verantwortungsgrenze bleibt dabei stabil.
Repositoryweiter Contract#
Dieser Bereich unterliegt dem Engineering Platform Scope, dem Engineering Platform Contract und der repositoryweiten Traceability. Bereichsspezifische Regeln konkretisieren diese Vorgaben, ersetzen sie jedoch nicht.
Build- und Pipeline-Nachweise#
Dauerhafte Verträge werden hier dokumentiert; veränderliche Laufnachweise folgen der Ablagegrenze aus Pipeline Evidence.
Roundtrip-Nachweise#
Roundtrip Evidence trennt dauerhafte Repositorynachweise von veränderlicher Runtime-Evidenz.
Packaging-Nachweise#
Packaging Evidence definiert die dauerhafte Nachweiskette.