Architecture Decision Record

Active theme: Light

← dokumenti

Linji gwida biex jinkisbu deċiżjonijiet sostenibbli

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

Tgħallimna l-lezzjonijiet li ġejjin fix-xogħol tagħna li jistgħu jservu bħala linji gwida u valutazzjoni biex jinkisbu deċiżjonijiet sostenibbli:

  1. Uża approċċ lean/minimalistiku għad-dokumentazzjoni inizjali tad-deċiżjonijiet.

  2. Agħti prijorità lid-deċiżjonijiet importanti kollha li huma rilevanti biżżejjed biex jiġu dokumentati u biex tinftiehem l-arkitettura fil-mira.

  3. Iddettalja d-deċiżjonijiet partikolarment importanti b'mudelli sħaħ biss wara li jkun sar ix-xogħol inizjali (jiġifieri, meta dawk li jieħdu d-deċiżjonijiet ikunu kuntenti bid-deċiżjonijiet arkitettoniċi meħudin u kunfidenti li dawn id-deċiżjonijiet m'għandhomx għalfejn jiġu riveduti dalwaqt).

  4. Uża l-verżjonijiet lean/minimalistiċi mill-pass 1 bħala verżjoni qasira ta' deċiżjonijiet dokumentati bil-livell xieraq ta' granularità biex tagħti ħarsa ġenerali lejn id-deċiżjonijiet dettaljati, kif ukoll għal deċiżjonijiet trivjali jew ovvji.

  5. Kull fejn ikun possibbli, uża l-għarfien arkitettoniku eżistenti, jew minn mudelli ta' gwida jew minn sorsi oħra. Irrevedi u estendi dan l-għarfien u adattah għall-kuntest tad-deċiżjoni speċifika.

  6. Żgura li jiġu stabbiliti rabtiet ta' traċċabbiltà bejn id-deċiżjonijiet u kemm ir-rekwiżiti kif ukoll id-disinji arkitettoniċi/il-kodiċi.

  7. Ipprovdi kontroll awtomatizzat tal-konsistenza biex tiżgura li r-rabtiet ta' traċċabbiltà jibqgħu sinkronizzati wara bidla. Illimita n-numru ta' dipendenzi bejn id-deċiżjonijiet u artefatti oħra tas-software.

  8. Applika l-linji gwida għall-ġustifikazzjonijiet b'mod konsistenti u b'qawwa—huma l-iktar parti importanti tad-dokumentazzjoni tad-deċiżjonijiet għax jagħtu r-raġunament.