Architecture Decision Record

Active theme: Light

← dokumendid

Meeskonnatöö nõuanded ADR-idele

Kui kaalute otsusekirjete kasutamist oma meeskonnas, siin on mõned nõuanded, mida õppisime mitme meeskonnaga töötades.

On võimalus juhtida meeskonnaliikmeid, rääkides "miks"-ist, mitte jõustades "mida". Näiteks on otsusekirjed viis, kuidas meeskonnad saavad nutikamalt mõelda ja paremini suhelda. Kui otsusekirjed on vaid tagantjärele jõustatav paberimajanduse nõue, pole neil väärtust.

Mõned meeskonnad eelistavad nime "otsused" tugevalt lühendile "ADR". Kui mõned meeskonnad kasutavad kausta nimena "decisions", süttib lamp ja meeskonnad hakkavad kausta panema rohkem teavet, nagu tarnijaotsused, plaaniotsused, ajakavaotsused ja nii edasi. Kõigi nende teabeliikide jaoks saab kasutada sama malli. Eeldame, et inimesed õpivad sõnaga ("otsus") kiiremini kui lühendiga ("ADR"), et sõna "kirje" väljajätmine annab rohkem motivatsiooni pooleliolevat tööd kirjutada ning et mõned arendajad ja mõned juhid ei salli sõna "arhitektuur".

Teoorias on muutumatus ideaalne. Praktikas töötas meie meeskonnale paremini muudetavus. Lisame olemasolevasse ADR-i uut teavet kuupäevatempli ja märkusega, et teave tuli pärast otsust. See lähenemine viib "elava dokumendini", mida me kõik saame uuendada. Tüüpilised uuendused tulevad teabe saamisest uute meeskonnaliikmete, uute pakkumiste, meie kasutuse tegelike tulemuste või hilisemate kolmandate osapoolte muudatuste tõttu, nagu tarnija funktsioonid, hinnaplaanid ja litsentsilepingud.