Architecture Decision Record

Active theme: Light

← dokumenter

Virschléi fir gutt ADR ze schreiwen

Charakteristike vun engem gudden ADR:

  • Begrënnung: Erkläert d'Grënn, firwat déi bestëmmten AD geholl gëtt. Dat kann de Kontext (kuckt ënnen), Virdeeler an Nodeeler vu verschiddene méigleche Choixen, Featurevergläicher, Käschten-/Notze-Diskussiounen a méi enthalen.

  • Spezifesch: All ADR soll iwwer eng AD goen, net iwwer méi AD.

  • Zäitstempel: Haalt fest, wéini all Element am ADR geschriwwe gouf. Dat ass besonnesch wichteg fir Aspekter, déi sech mat der Zäit kënne änneren, wéi Käschten, Zäitplang, Skaléierung an Ähnleches.

  • Onverännerbar: Ännert keng bestoend Informatioun an engem ADR. Amplaz ergänzt den ADR mat neier Informatioun, oder léist den ADR duerch en neien ADR of.

Charakteristike vun enger gudder "Kontext"-Rubrik an engem ADR:

  • Erkläert d'Situatioun vun Ärer Organisatioun an d'Geschäftsprioritéiten.

  • Bezitt Begrënnungen an Iwwerleeungen mat an, déi op der sozialer a kompetenzbaséierter Zesummesetzung vun Ären Teams baséieren.

  • Bezitt Pro- a Kontra-Argumenter mat an, déi relevant sinn, a beschreift se esou, datt se zu Äre Bedürfnisser an Zieler passen.

Charakteristike vun enger gudder "Konsequenzen"-Rubrik an engem ADR:

  • Erkläert, wat aus der Decisioun follegt. Dat kann d'Effekter, d'Resultater, d'Outputs, d'Follow-ups a méi enthalen.

  • Bezitt Informatioune iwwer all nofollgend ADR mat an. Et ass relativ üblech, datt een ADR de Besoin u weidere ADR ausléist, zum Beispill wann een ADR eng grouss iwwergräifend Wiel mécht, déi dann de Besoin u méi klenge Decisiounen erstellt.

  • Bezitt all Review-Prozesser nom Handelen mat an. Et ass typesch, datt Teams all ADR een Mount méi spéit nokucken, fir d'ADR-Informatioun mat deem ze vergläichen, wat an der Praxis geschitt ass, fir ze léieren an ze wuessen.

E neien ADR ka vun engem fréiere ADR iwwerholl:

  • Wann eng AD geholl gëtt, déi e fréiere ADR ersetzt oder ongëlteg mécht, da soll en neien ADR erstallt ginn