Richtlinne fir nohalteg Decisiounen z'erreechen

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

A eiser Aarbecht hu mir déi folgend Lektioune geléiert, déi als Richtlinn a Bewäertung fir d'Erreeche vun nohaltegen Decisioune kënne déngen:

1. Benotzt en Lean-/Minimalistesch Usaz fir déi éischt Decisiounsdokumentatioun.

2. Prioritiséiert an erfaasst all wichteg Decisiounen, déi relevant genuch sinn, fir se ze dokumentéieren an d'Zilarchitektur ze verstoen.

3. Detailléiert déi besonnesch wichteg Decisiounen nëmmen duerno mat voll ausgebauten Virlagen, wann déi éischt Aarbecht gemaach ass (dat heescht, wann d'Decisiounsträger mat den getroffenen Architekturdecisioune zefridde sinn a sécher sinn, datt dës Decisioune net esou séier musse revidéiert ginn).

4. Benotzt déi Lean-/Minimalistesch Versioune vum Schrëtt 1 als kuerz Versioun vun dokumentéierten Decisiounen mat dem richtege Granularitéitsniveau, fir en Iwwerbléck iwwer d'detailléiert Decisiounen ze ginn, souwéi fir trivial oder offensichtlech Decisiounen.

5. Wou et méiglech ass, benotzt bestoend Architekturwëssen, entweder aus Guidance-Modeller oder aus anere Quellen. Iwwerpréift an erweidert esou Wëssen a passt et un de Kontext vun der spezifescher Decisioun un.

6. Stellt sécher, datt Traceability-Linke tëscht Decisiounen a souwuel Ufuerderungen wéi och Architekturdesigns/Code etabléiert sinn.

7. Bitt automatiséiert Konsistenzkontroll un, fir sécherzestellen, datt d'Traceability-Linke no enger Ännerung synchron sinn. Begrenzt d'Zuel vun Ofhängegkeeten tëscht Decisiounen an aneren Softwareartefakten.

8. Wendt d'Richtlinne fir d'Rechtfäerdegunge konsequent a nodrécklech un — si sinn deen wichtegste Deel vun der Decisiounsdokumentatioun, well si d'Begrënnung ginn.