Architecture Decision Record

Active theme: Light

← dogfennau

Awgrymiadau ar gyfer ysgrifennu ADRau da

Nodweddion ADR da:

  • Sail resymegol: Eglurwch y rhesymau dros wneud yr AD penodol. Gall hyn gynnwys y cyd-destun (gweler isod), manteision ac anfanteision y dewisiadau posibl, cymariaethau o nodweddion, trafodaethau cost a budd, a mwy.

  • Penodol: Dylai pob ADR ymwneud ag un AD, nid sawl AD.

  • Stampiau amser: Nodwch pryd yr ysgrifennwyd pob eitem yn yr ADR. Mae hyn yn arbennig o bwysig ar gyfer agweddau a all newid dros amser, fel costau, amserlenni, graddio, ac ati.

  • Digyfnewid: Peidiwch â newid gwybodaeth sydd eisoes mewn ADR. Yn hytrach, diwygiwch yr ADR drwy ychwanegu gwybodaeth newydd, neu disodlwch yr ADR drwy greu ADR newydd.

Nodweddion adran "Cyd-destun" dda mewn ADR:

  • Eglurwch sefyllfa eich sefydliad a'i flaenoriaethau busnes.

  • Cynhwyswch y sail resymegol a'r ystyriaethau sy'n seiliedig ar gyfansoddiad cymdeithasol a sgiliau eich timau.

  • Cynhwyswch fanteision ac anfanteision sy'n berthnasol, a disgrifiwch nhw mewn termau sy'n cyd-fynd â'ch anghenion a'ch nodau.

Nodweddion adran "Canlyniadau" dda mewn ADR:

  • Eglurwch beth sy'n dilyn o wneud y penderfyniad. Gall hyn gynnwys yr effeithiau, y deilliannau, yr allbynnau, y camau dilynol, a mwy.

  • Cynhwyswch wybodaeth am unrhyw ADRau dilynol. Mae'n gymharol gyffredin i un ADR greu'r angen am ragor o ADRau, er enghraifft pan fydd un ADR yn gwneud dewis mawr cyffredinol sydd yn ei dro yn creu'r angen am fwy o benderfyniadau llai.

  • Cynhwyswch unrhyw brosesau adolygu ar ôl y weithred. Mae'n arferol i dimau adolygu pob ADR fis yn ddiweddarach, i gymharu gwybodaeth yr ADR â'r hyn sydd wedi digwydd yn ymarferol, er mwyn dysgu a datblygu.

Gall ADR newydd gymryd lle ADR blaenorol:

  • Pan wneir AD sy'n disodli neu'n annilysu ADR blaenorol, dylid creu ADR newydd