Architecture Decision Record

Active theme: Light

← dokumenti

Min jista' joħloq ADR?

Ikkunsidra oqsma bħal persuni speċifiċi, jew rwoli speċifiċi, jew timijiet speċifiċi, jew dipartimenti speċifiċi; ikkunsidra wkoll jekk hemmx persuni, jew rwoli, jew timijiet, jew dipartiment li jistgħu jikkummissjonaw ADR, jiġifieri jitolbu wieħed li xi ħadd ieħor jikteb.

Eżempju ta' tweġiba: Kwalunkwe persuna fl-organizzazzjoni tagħna li qrat il-paġna README tar-rekord ta' deċiżjoni arkitettonika tista' tipproponi ADR, jiġifieri tista' tibda tikteb wieħed, u taqsmu mat-tim.

X'jiġġustifika l-ħolqien ta' ADR?

Ikkunsidra oqsma bħall-modi ta' ħidma tat-timijiet tal-organizzazzjoni tiegħek, l-istruttura tas-sistema tas-software tiegħek, il-koordinazzjoni bejn it-timijiet, il-manutenibbiltà fit-tul, l-interfaces esterni, min trid li jibbenefika, u affarijiet simili.

Eżempju ta' tweġiba: Irridu noħolqu ADR meta rridu li l-iżviluppaturi futuri jifhmu l-"għaliex" ta' dak li qed nagħmlu.

X'jiġġustifika li ma jinħolqx ADR?

Ikkunsidra oqsma bħal deċiżjonijiet li mhumiex dwar l-arkitettura, jew li huma ċkejkna bħal riskju minimu jew awtonomi jew ta' żviluppatur wieħed, jew li diġà huma koperti bis-sħiħ x'imkien ieħor bħal fi standards jew politiki jew dokumentazzjoni, jew li huma temporanji bħal soluzzjonijiet alternattivi jew provi tal-kunċett jew esperimenti.

Eżempju ta' tweġiba: Irridu naqbżu ADR meta deċiżjoni hija limitata fl-ambitu u fiż-żmien u fir-riskju u fl-ispiża, jew diġà hija koperta x'imkien ieħor.

X'inhu ċ-ċiklu tal-ħajja ta' ADR?

Ikkunsidra oqsma bħall-proċess tal-ħolqien, il-proċess tar-riċerka, il-proċess tat-teħid tad-deċiżjoni, il-proċess tal-implimentazzjoni, u l-proċess tat-tmiem. Ikkunsidra kif tittraċċa ċ-ċiklu tal-ħajja tal-ADR maż-żmien, bħal kif tmexxi l-ADR minn stat għall-ieħor, u wkoll kif tikkomunika dan lill-partijiet interessati.

Eżempju ta' tweġiba: Irridu li ADR ikollu ħames stadji taċ-ċiklu tal-ħajja: Bidu → Riċerka → Evalwazzjoni → Implimentazzjoni → Manutenzjoni → Tmiem.

X'inhuma l-kriterji għall-passi taċ-ċiklu tal-ħajja ta' ADR?

Ikkunsidra oqsma bħal kriterji ta' aċċettazzjoni għal ADR, jiġifieri kif taf li huwa tajjeb biżżejjed biex jipprogressa minn pass taċ-ċiklu tal-ħajja għall-ieħor? Il-problema hija spjegata b'mod ċar? Intlaqgħu l-alternattivi? Il-kompromessi huma mifhuma u dokumentati biżżejjed? Il-kuntest rilevanti kollu qiegħed f'postu? Il-partijiet interessati rilevanti kollha huma involuti? Il-feedback kollu ġie inkorporat?

Eżempju ta' tweġiba: Irridu li ADR jitpoġġa għall-vot mill-partijiet interessati meta t-tim attiv ikun 1) lesta r-riċerka tiegħu, 2) lesta l-evalwazzjoni tiegħu, 3) ippubblika l-proposta tal-ADR lill-partijiet interessati b'talba għal kummenti u b'limitu ta' ġimgħa, 4) il-kummenti kollha tal-partijiet interessati jkunu ġew inkorporati u indirizzati.

X'rwoli u responsabbiltajiet jinteraġixxu ma' ADR?

Ikkunsidra rwoli bħal min jipproponi, ir-riċerkatur, l-evalwatur, ir-reviżur, l-approvatur, il-persuna li żżomm, u affarijiet simili. Ikkunsidra responsabbiltajiet bħall-komunikazzjoni mal-partijiet interessati, l-assigurazzjoni li l-aspettattivi jintlaħqu, il-qsim fuq il-websajt jew l-intranet, u r-reviżjoni tax-xogħol perjodikament u speċjalment meta jseħħu bidliet rilevanti.

Eżempju ta' tweġiba: Irridu li kull ADR dejjem ikollu persuna ta' kuntatt primarja, persuna ta' kuntatt sekondarja, u tim responsabbli; dawn huma responsabbli għall-komunikazzjonijiet, il-pubblikazzjonijiet, il-manutenzjoni, ir-reviżjoni perjodika mill-inqas darba fis-sena, u t-tmiem eventwali kif meħtieġ.

Kif tinteraġixxi l-governanza ma' ADR?

Ikkunsidra oqsma bħall-modi ta' ħidma tal-organizzazzjoni tiegħek, kwalunkwe ħtieġa speċjali ta' konformità bħal għal aspetti legali jew aspetti tar-riżorsi umani, kif tixtieq timmaniġġja l-kunsens kontra l-kunflitt kontra l-eskalazzjoni. Hemm oqsma jew persuni jew timijiet li jistgħu jkollhom aktar influwenza minn oħrajn dwar ADR, bħal li jkunu jistgħu japprovawh, jew jivvutaw fuqu, jew jipponu veto fuqu?

Eżempju ta' tweġiba: Il-governanza ta' ADR hija f'dan l-ordni ta' prijorità: is-CEO, is-CTO, is-CLO, it-tim li jimplimenta ADR, l-esperti fit-tim li huma l-aktar kapaċi dwar l-AD. Ħadd ieħor ma għandu governanza sakemm ma jkunx deskritt fl-ADR.

X'prinċipji jinteraġixxu ma' ADR?

Ikkunsidra oqsma bħall-modi ta' ħidma tal-organizzazzjoni tiegħek li jinkludu li tiċċaqlaq malajr kontra li tiċċaqlaq bil-mod, għal kunsens fid-deċiżjonijiet kontra kunflitt fid-deċiżjonijiet, u għal preferenzi dwar ir-riskju kontra preferenzi dwar is-sikurezza, diskussjoni pubblika kontra diskussjoni privata, u affarijiet simili.

Eżempju ta' tweġiba: Nużaw il-prinċipji tat-tmexxija ta' preferenza għall-azzjoni, nkunu ma' qbiela u nikkommettu (disagree-and-commit), stimi ta' 70% huma tajbin biżżejjed għal deċiżjonijiet faċilment riversibbli u faċilment iżolabbli, u modi ta' ħidma pubbliċi bl-eċċezzjoni ta' informazzjoni kunfidenzjali kif deskritt fil-ftehim ta' kunfidenzjalità tal-organizzazzjoni tagħna.