Architecture Decision Record

Active theme: Light

← dokumenti

Suġġerimenti biex tikteb ADR tajbin

Karatteristiċi ta' ADR tajjeb:

  • Raġunament: Spjega r-raġunijiet għaliex tittieħed l-AD partikolari. Dan jista' jinkludi l-kuntest (ara hawn taħt), il-vantaġġi u l-iżvantaġġi ta' għażliet potenzjali differenti, tqabbil tal-karatteristiċi, diskussjonijiet dwar l-ispiża u l-benefiċċju, u aktar.

  • Speċifiku: Kull ADR għandu jkun dwar AD waħda, mhux dwar ħafna AD.

  • Timestamps: Identifika meta nkiteb kull element tal-ADR. Dan huwa importanti speċjalment għal aspetti li jistgħu jinbidlu maż-żmien, bħall-ispejjeż, l-iskedi, l-iskalar, u affarijiet simili.

  • Immutabbli: Tbiddilx l-informazzjoni eżistenti f'ADR. Minflok, immodifika l-ADR billi żżid informazzjoni ġdida, jew ibdel l-ADR b'ADR ġdid.

Karatteristiċi ta' sezzjoni "Kuntest" tajba f'ADR:

  • Spjega s-sitwazzjoni tal-organizzazzjoni tiegħek u l-prijoritajiet tan-negozju.

  • Inkludi r-raġunament u l-konsiderazzjonijiet ibbażati fuq il-kompożizzjoni soċjali u tal-ħiliet tat-timijiet tiegħek.

  • Inkludi l-vantaġġi u l-iżvantaġġi rilevanti, u ddeskrivihom b'termini li jaqblu mal-bżonnijiet u l-għanijiet tiegħek.

Karatteristiċi ta' sezzjoni "Konsegwenzi" tajba f'ADR:

  • Spjega dak li jirriżulta mit-teħid tad-deċiżjoni. Dan jista' jinkludi l-effetti, ir-riżultati, l-outputs, is-segwiti, u aktar.

  • Inkludi informazzjoni dwar kwalunkwe ADR sussegwenti. Huwa relattivament komuni li ADR wieħed iqajjem il-ħtieġa għal aktar ADR, bħal meta ADR wieħed jieħu għażla kbira u ġenerali li min-naħa tagħha toħloq bżonn ta' aktar deċiżjonijiet iżgħar.

  • Inkludi kwalunkwe proċess ta' reviżjoni wara l-azzjoni. Huwa tipiku li t-timijiet jirrevedu kull ADR xahar wara, biex iqabblu l-informazzjoni tal-ADR ma' dak li ġara fil-prattika, sabiex jitgħallmu u jikbru.

ADR ġdid jista' jieħu post ADR preċedenti:

  • Meta tittieħed AD li tieħu post jew tinvalida ADR preċedenti, għandu jinħoloq ADR ġdid