Architecture Decision Record

Active theme: Light

← dokumentai

Kas gali sukurti ADR?

Apsvarstykite tokias sritis kaip konkretūs žmonės, konkrečios pareigos, konkrečios komandos ar konkretūs skyriai; taip pat apsvarstykite, ar yra žmonių, pareigų, komandų ar skyrių, kurie gali užsakyti ADR, t. y. paprašyti, kad jį parašytų kas nors kitas.

Atsakymo pavyzdys: bet kuris mūsų organizacijos asmuo, perskaitęs architektūros sprendimo įrašo README puslapį, gali pasiūlyti ADR, t. y. gali pradėti jį rašyti ir pasidalyti juo su komanda.

Kas pateisina ADR kūrimą?

Apsvarstykite tokias sritis kaip jūsų organizacijos komandų darbo būdai, programinės įrangos sistemos struktūra, tarpkomandinis koordinavimas, ilgalaikis prižiūrimumas, išorinės sąsajos, kam norite duoti naudos ir panašiai.

Atsakymo pavyzdys: ADR norime kurti, kai norime, kad būsimi programuotojai suprastų, „kodėl“ darome tai, ką darome.

Kas pateisina ADR nekūrimą?

Apsvarstykite tokias sritis kaip sprendimai, kurie nėra susiję su architektūra arba yra smulkūs, pavyzdžiui, mažos rizikos, savarankiški ar vieno programuotojo sprendimai, arba jau visiškai aprėpti kitur, pavyzdžiui, standartuose, politikose ar dokumentacijoje, arba yra laikini, pavyzdžiui, apėjimo būdai, koncepcijos įrodymai ar eksperimentai.

Atsakymo pavyzdys: ADR norime praleisti, kai sprendimo apimtis, trukmė, rizika ir kaina yra ribotos arba jis jau aprėptas kitur.

Koks yra ADR gyvavimo ciklas?

Apsvarstykite tokias sritis kaip kūrimo procesas, tyrimo procesas, sprendimo priėmimo procesas, įgyvendinimo procesas ir nutraukimo procesas. Apsvarstykite, kaip sekti ADR gyvavimo ciklą laikui bėgant, pavyzdžiui, kaip perkelti ADR iš vienos būsenos į kitą ir kaip apie tai informuoti suinteresuotuosius asmenis.

Atsakymo pavyzdys: norime, kad ADR turėtų penkis gyvavimo ciklo etapus: inicijavimas → tyrimas → vertinimas → įgyvendinimas → priežiūra → nutraukimas.

Kokie yra ADR gyvavimo ciklo žingsnių kriterijai?

Apsvarstykite tokias sritis kaip ADR priėmimo kriterijai, t. y. kaip žinoti, kad jis pakankamai geras, kad pereitų iš vieno gyvavimo ciklo žingsnio į kitą? Ar problema aiškiai suformuluota? Ar apsvarstytos alternatyvos? Ar kompromisai pakankamai gerai suprasti ir dokumentuoti? Ar visas svarbus kontekstas pateiktas? Ar įtraukti visi svarbūs suinteresuotieji asmenys? Ar atsižvelgta į visas atsiliepimus?

Atsakymo pavyzdys: norime, kad suinteresuotieji asmenys dėl ADR balsuotų, kai aktyvi komanda: 1) baigė tyrimą, 2) baigė vertinimą, 3) paskelbė ADR pasiūlymą suinteresuotiesiems asmenims prašydama komentarų su vienos savaitės laiko riba, 4) į visus suinteresuotųjų asmenų komentarus atsižvelgta ir jie išspręsti.

Kokios pareigos ir atsakomybės sąveikauja su ADR?

Apsvarstykite tokias pareigas kaip pasiūlytojas, tyrėjas, vertintojas, peržiūrėtojas, tvirtintojas, prižiūrėtojas ir panašiai. Apsvarstykite tokias atsakomybes kaip bendravimas su suinteresuotaisiais asmenimis, lūkesčių išpildymo užtikrinimas, dalijimasis svetainėje ar intranete ir darbo periodinė peržiūra, ypač kai įvyksta svarbių pokyčių.

Atsakymo pavyzdys: norime, kad kiekvienas ADR visada turėtų pagrindinį kontaktinį asmenį, antrinį kontaktinį asmenį ir atsakingą komandą; jie atsakingi už komunikaciją, publikavimą, priežiūrą, periodinę peržiūrą bent kartą per metus ir galimą nutraukimą, kai reikia.

Kaip valdysena sąveikauja su ADR?

Apsvarstykite tokias sritis kaip jūsų organizacijos darbo būdai, ypatingi atitikties poreikiai, pavyzdžiui, teisiniai ar žmogiškųjų išteklių aspektai, kaip norite spręsti konsensuso, konflikto ir eskalavimo klausimus. Ar yra sričių, žmonių ar komandų, kurie dėl ADR gali turėti daugiau įtakos nei kiti, pavyzdžiui, galėti jį patvirtinti, dėl jo balsuoti ar uždėti veto?

Atsakymo pavyzdys: ADR valdysena eina šia prioriteto tvarka: generalinis direktorius (CEO), technologijų direktorius (CTO), teisės direktorius (CLO), komanda, įgyvendinanti ADR, komandos ekspertai, geriausiai išmanantys AD. Niekas kitas neturi valdysenos teisių, nebent tai aprašyta ADR.

Kokie principai sąveikauja su ADR?

Apsvarstykite tokias sritis kaip jūsų organizacijos darbo būdai, apimantys greitą ar lėtą judėjimą, sprendimų konsensusą ar sprendimų konfliktą, rizikos ar saugumo pirmenybes, viešą ar privačią diskusiją ir panašiai.

Atsakymo pavyzdys: naudojame šiuos lyderystės principus: polinkis veikti, nesutikti ir įsipareigoti, 70 % įvertinimų pakanka lengvai atšaukiamiems ir lengvai izoliuojamiems sprendimams, ir viešas darbo būdas, išskyrus konfidencialią informaciją, kaip aprašyta mūsų organizacijos konfidencialumo sutartyje.