Styleguide und Architekturpinzipien
Vor einiger Zeit waren Styleguides populär. Im Internet findet man immer noch einige der Angebote. Anwender fragen auch heute danach.
Wir bieten drei Dokumente als Hilfe-Stellung an
- Den Styleguide
- Die Modellierungsrichtinien
- Governance-Regeln
Alle drei Dokumente geben Hilfe bei der Modellierung und sichern Einheitlichkeit bei der Modellierung. Erste Vorraussetzung ist ein Rollenverständnis der beteiligten Projektmitarbeiter. Nicht jede Regel adressiert jedes Projektmitglied.
- Der Styleguide regelt, wie wir Notationen und Beschreibungsmittel einsetzen. Wir schränken Standardnotationen ein. Er gibt Beispiele und definiert Modellierungsmuster. Er regelt aber auch einfache Sachverhalte, wie die farbliche Gestaltung.
- Die Modellierungsrichtlinien geben Hilfe, welches Vorgehen wir wählen, erklärt Arbeitstechniken und Soft-Skills wir anwenden und einsetzen.
- Die Governance-Regeln sichern Konformität und Aktualität der Modelle. Hier spielen viele Spielregeln und „Zeremonien“ eine Rolle.
Eine Grundlage sind Architekturprinzipien. Architekturprinzipien setzen den Rahmen für die drei genannten Dokumente. TOGAF® gibt Beispiele für solche Prinzipien und betont, dass ein übliches Projekt nicht mehr als 20 Architekturprinzipien haben sollte. Hier sind Beispiele meiner Architekturprinzipien als Grundlage von Styleguide, Modellierungsrichtlinie, Governance-Regeln.