Architecture Decision Record

Active theme: Light

← dokumenti

Ieteikumi labu ADR rakstīšanai

Laba ADR raksturojums:

  • Pamatojums: paskaidrojiet iemeslus konkrētā AD īstenošanai. Tas var ietvert kontekstu (skatiet tālāk), dažādu iespējamo izvēļu priekšrocības un trūkumus, funkciju salīdzinājumus, izmaksu un ieguvumu apspriešanu un citu.

  • Konkrētība: katram ADR jābūt par vienu AD, nevis vairākiem AD.

  • Laika zīmogi: norādiet, kad katrs ADR elements ir uzrakstīts. Tas ir īpaši svarīgi aspektiem, kas laika gaitā var mainīties, piemēram, izmaksām, grafikiem, mērogošanai un tamlīdzīgi.

  • Nemainīgums: nemainiet ADR esošo informāciju. Tā vietā papildiniet ADR, pievienojot jaunu informāciju, vai aizstājiet ADR, izveidojot jaunu ADR.

Laba ADR sadaļas „Konteksts” raksturojums:

  • Paskaidrojiet savas organizācijas situāciju un biznesa prioritātes.

  • Iekļaujiet pamatojumu un apsvērumus, kas balstīti uz jūsu komandu sociālo sastāvu un prasmēm.

  • Iekļaujiet atbilstošas priekšrocības un trūkumus un aprakstiet tos izteiksmēs, kas atbilst jūsu vajadzībām un mērķiem.

Laba ADR sadaļas „Sekas” raksturojums:

  • Paskaidrojiet, kas izriet no lēmuma pieņemšanas. Tas var ietvert ietekmi, iznākumus, rezultātus, turpmākās darbības un citu.

  • Iekļaujiet informāciju par jebkuriem turpmākiem ADR. Ir samērā ierasti, ka viens ADR izraisa vajadzību pēc papildu ADR, piemēram, kad viens ADR pieņem lielu pārsvarā esošu izvēli, kas savukārt rada vajadzību pēc vairākiem mazākiem lēmumiem.

  • Iekļaujiet jebkurus pēcdarbības pārskata procesus. Komandām ir tipiski pārskatīt katru ADR vienu mēnesi vēlāk, lai salīdzinātu ADR informāciju ar to, kas noticis praksē, un tā mācītos un attīstītos.

Jauns ADR var aizstāt iepriekšējo ADR:

  • Kad tiek pieņemts AD, kas aizstāj vai anulē iepriekšējo ADR, jāizveido jauns ADR