Architecture Decision Record

Active theme: Light

← dokumentai

Komandinio darbo patarimai dėl ADR

Jei svarstote su savo komanda naudoti sprendimų įrašus, štai keletas patarimų, kuriuos išmokome dirbdami su daugeliu komandų.

Turite galimybę vesti komandos narius pirmyn kartu kalbėdami apie „kodėl“, o ne primesdami „ką“. Pavyzdžiui, sprendimų įrašai yra būdas komandoms protingiau mąstyti ir geriau bendrauti; sprendimų įrašai neturi vertės, jei tai tik po fakto primesti popieriai.

Kai kurios komandos daug labiau mėgsta pavadinimą „sprendimai“ nei santrumpą „ADR“. Kai kai kurios komandos naudoja katalogo pavadinimą „decisions“, tarsi įsijungia lemputė, ir komanda pradeda į katalogą dėti daugiau informacijos, pavyzdžiui, tiekėjų sprendimus, planavimo sprendimus, tvarkaraščių sprendimus ir pan. Visiems šiems informacijos tipams galima naudoti tą patį šabloną. Spėjame, kad žmonės greičiau mokosi iš žodžių („sprendimai“) nei iš santrumpų („ADR“), kad žmones labiau motyvuoja rašyti nebaigtus dokumentus, kai žodis „įrašas“ pašalinamas, o kai kurie programuotojai ir vadovai taip pat nemėgsta žodžio „architektūra“.

Teoriškai nekeičiamumas yra idealus. Praktiškai mūsų komandoms geriau pasiteisino keičiamumas. Naują informaciją įterpiame į esamą ADR su datos žyma ir pastaba, kad informacija atsirado po sprendimo. Toks požiūris veda prie „gyvo dokumento“, kurį visi galime atnaujinti. Tipiniai atnaujinimai atsiranda, kai informaciją gauname dėl naujų komandos narių, naujų pasiūlymų, realių mūsų naudojimo rezultatų arba po fakto įvykusių trečiųjų šalių pokyčių, pavyzdžiui, tiekėjų galimybių, kainodaros planų, licencijų sutarčių ir pan.