cards+
Das Prinzip SLA
Nur ein Abstraktionsniveau Single level of abstraction

clean-code-developer

Das Prinzip SLA spiegelt sich in der Struktur der Seiten im Wiki wider. Für jede Seite im Wiki gibt es einen Baustein, in dem klar definiert ist,

  • welchem Bereich die Seite zugeordnet ist,
  • welchen formalen Aufbau die Seite hat,
  • was in der Seite beschrieben wird und
  • was nicht in diese Seite gehört.

Mit Bereich ist dabei die Unterscheidung der Bausteine für Systembeschreibung, Systemstruktur und Architekturentwurf gemeint. Mit der Zuordnung zum Bereich ist auch klar, in welchen Prozessen der Baustein erstellt oder aktualisiert wird. Gerade bei der Beschreibung fachlicher Inhalte arbeiten oft Personen zusammen, deren Fähigkeiten sehr unterschiedlich sind. Um diese Zusammenarbeit effizient zu gestalten, muss das Abstraktionsniveau klar sein.

Ein konkretes Beispiel ist der Baustein Case. Er hat eine Beschreibung der Ausgangslage und eine Lösung. Die Lösung wird nicht bis ins kleinste Detail beschrieben. Sie wird nur in Form von Essenzschritte mit Verknüpfung zu den Bausteinen der Systemstruktur dokumentiert. Die Details der Lösung finden sich nur in den Bausteinen Layout, Service, Event und Entity.