Architecture Decision Record

Active theme: Light

← dokumenti

Vadlīnijas ilgtspējīgu lēmumu sasniegšanai

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

Savā darbā mēs apguvām šādas mācības, kas var kalpot kā vadlīnijas un novērtējums ilgtspējīgu lēmumu sasniegšanai:

  1. Sākotnējai lēmumu dokumentēšanai izmantojiet viegli/minimālistisku pieeju.

  2. Piešķiriet prioritāti un fiksējiet visus svarīgos lēmumus, kas ir pietiekami būtiski, lai tos dokumentētu un izprastu mērķa arhitektūru.

  3. Īpaši svarīgos lēmumus detalizējiet ar pilnām veidnēm tikai pēc sākotnējā darba paveikšanas (proti, kad lēmumu pieņēmēji ir apmierināti ar pieņemtajiem arhitektūras lēmumiem un pārliecināti, ka šie lēmumi drīz nebūs jāpārskata).

  4. Izmantojiet 1. soļa viegli/minimālistiskās versijas kā īsu dokumentēto lēmumu versiju ar pareizo granularitātes līmeni, lai nodrošinātu detalizēto lēmumu pārskatu, kā arī triviāliem vai acīmredzamiem lēmumiem.

  5. Kur vien iespējams, izmantojiet esošās arhitektūras zināšanas, vai nu no vadlīniju modeļiem, vai citiem avotiem. Pārskatiet un paplašiniet šādas zināšanas un pielāgojiet tās konkrētā lēmuma kontekstam.

  6. Nodrošiniet, ka starp lēmumiem un gan prasībām, gan arhitektūras dizainiem/kodu ir izveidotas izsekojamības saites.

  7. Nodrošiniet automatizētu konsekvences pārbaudi, lai pārliecinātos, ka izsekojamības saites pēc izmaiņām ir sinhronizētas. Ierobežojiet atkarību skaitu starp lēmumiem un citiem programmatūras artefaktiem.

  8. Piemērojiet pamatojumu vadlīnijas konsekventi un stingri – tās ir svarīgākā lēmumu dokumentācijas daļa, jo tās sniedz pamatojumu.