Grundprinzipien einer Architektur-Dokumentation: Erkläre, Teil 2

Mischa Sameli, Geschäftsführer & Leiter Entwicklung

Erkläre jedes Element in Diagrammen: Erkläre sämtliche Elemente – Bausteine und Beziehungen – innerhalb von Diagrammen.

Das wirkt nach den bisherigen Tipps sowohl penetrant als auch in gewissem Sinn redundant. Aber an dieser Stelle finde ich Redundanz sinnvoll. Denn Kästchen, Kreise, Sternchen und was es sonst noch alles gibt, gefüllt mit Schlagwörtern, sagen meistens einfach noch nicht so viel aus. Beziehungen zueinander und deren Bedeutung kann man meist nur erraten. Hape lässt grüssen.