Architecture Decision Record

Active theme: Light

← dokumendid

Juhised jätkusuutlike otsuste saavutamiseks

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

Oma töös õppisime järgmised õppetunnid, mida saab kasutada juhiste ja hindamiskriteeriumidena jätkusuutlike otsuste saavutamiseks:

  1. Kasuta otsuste esialgses dokumenteerimises lean/minimalistlikku lähenemist.

  2. Pane tähtsuse järjekorda ja jäädvusta kõik olulised otsused, mis on piisavalt asjakohased sihtarhitektuuri dokumenteerimiseks ja mõistmiseks.

  3. Täpsusta eriti olulisi otsuseid täismahus malliga alles pärast esialgset tööd (st kui otsustajad on langetatud arhitektuuriotsustega rahul ja on kindlus, et neid otsuseid ei pea peagi läbi vaatama).

  4. Kasuta 1. sammu lean/minimalistlikku versiooni sobival granulaarsustasemel dokumenteeritud otsuste kokkuvõttena, et anda ülevaade üksikasjalikest otsustest, ja ka triviaalsete või iseenesestmõistetavate otsuste jaoks.

  5. Kasuta võimalusel olemasolevaid arhitektuuriteadmisi, olgu need juhtmudelid või muud allikad. Vaata need üle, laienda neid ja kohanda konkreetsete otsuste kontekstiga.

  6. Taga, et jälgitavuse lingid luuakse otsuste ning nõuete ja arhitektuuridisaini/koodi vahel.

  7. Paku automaatseid järjepidevuskontrolle, et jälgitavuse lingid püsiksid pärast muudatusi sünkroonis. Piira otsuste ja teiste tarkvaraartefaktide vaheliste sõltuvuste arvu.

  8. Rakenda põhjenduse juhiseid järjepidevalt ja jõuliselt. Põhjendus on otsuse dokumenteerimise kõige olulisem osa, sest see annab põhjuse.