Architecture Decision Record

Active theme: Light

← dokumenter

Wien kann en ADR erstellen?

Berécksiichtegt Beräicher wéi spezifesch Persounen, spezifesch Rollen, spezifesch Teams oder spezifesch Departementer; berécksiichtegt och, ob et Persounen, Rollen, Teams oder Departementer gëtt, déi en ADR a Optrag ginn kënnen, dat heescht, si froen een un, deen een anere schreift.

Beispillantwert: All Persoun an eiser Organisatioun, déi d'README-Säit vun der Architektur-Decisiounsopzeechnung gelies huet, kann en ADR virschloen, dat heescht, d'Persoun ka mat der Schreiwen ufänken an en dem Team matdeelen.

Wat rechtfäerdegt et, en ADR unzeleeën?

Berécksiichtegt Beräicher wéi d'Aarbechtsweisen vun Ärer Organisatioun an Teams, d'Struktur vun Ärem Softwaresystem, d'Koordinatioun tëscht Teams, laangfristeg Wartbarkeet, extern Schnëttstellen, wiem Dir wëllt notzen, an Ähnleches.

Beispillantwert: Mir wëllen en ADR erstellen, wa mir wëllen, datt zukünfteg Entwéckler d'"Firwat" vun deem verstoen, wat mir maachen.

Wat rechtfäerdegt et, keen ADR unzeleeën?

Berécksiichtegt Beräicher wéi Decisiounen, déi net d'Architektur betreffen, oder winzeg sinn, zum Beispill mat minimalem Risiko oder selbststänneg oder fir en eenzegen Entwéckler, oder schonn anzwuesch voll ofgedeckt sinn, zum Beispill duerch Standarden oder Politiken oder Dokumentatioun, oder temporär sinn, zum Beispill Workarounds oder Proofs of Concept oder Experimenter.

Beispillantwert: Mir wëllen en ADR iwwersprangen, wann eng Decisioun a Géigewier vun Ëmfang, Zäit, Risiko a Käschte limitéiert ass, oder schonn anzwuesch ofgedeckt ass.

Wat ass de Lifecycle vun engem ADR?

Berécksiichtegt Beräicher wéi de Prozess vun der Erstellung, d'Recherche, de Prozess vun der Decisiounsfannung, d'Ëmsetzung an d'Ausleeë vun engem ADR. Berécksiichtegt, wéi de Lifecycle vum ADR mat der Zäit verfollegt gëtt, zum Beispill wéi de ADR vun engem Zoustand an deen nächsten bewegt gëtt, an och wéi dat de Stakeholder matgedeelt gëtt.

Beispillantwert: Mir wëllen, datt en ADR fënnef Lifecycle-Stadie huet: Initiéieren → Recherchéieren → Evaluéieren → Ëmsetzen → Erhalen → Ausleeën.

Wat sinn d'Critèrë fir d'Lifecycle-Schrëtt vun engem ADR?

Berécksiichtegt Beräicher wéi Akzeptanzcritèrë fir en ADR, dat heescht, wéi weess een, datt en gutt genuch ass, fir vun engem Lifecycle-Schrëtt an deen nächsten ze goen? Ass de Problem kloer formuléiert? Goufen d'Alternative berécksiichtegt? Sinn d'Kompromësser gutt genuch verstanen an dokumentéiert? Ass de ganze relevante Kontext do? Sinn all relevant Stakeholder involvéiert? Gouf all Feedback agebaut?

Beispillantwert: Mir wëllen, datt iwwer en ADR vun de Stakeholder ofgestëmmt gëtt, wann dat aktivt Team 1) seng Recherche ofgeschloss huet, 2) seng Evaluatioun ofgeschloss huet, 3) de Virschlag fir den ADR de Stakeholder mat enger Ufro fir Kommentare an enger Zäitbegrenzung vun enger Woch publizéiert huet, 4) all Kommentare vun de Stakeholder agebaut an adresséiert goufen.

Wéi eng Rolle a Verantwortlechkeeten interagéieren mat engem ADR?

Berécksiichtegt Rolle wéi Virschloender, Recherchéierer, Evaluator, Reviewer, Genehmegen, Maintainer an Ähnleches. Berécksiichtegt Verantwortlechkeeten wéi d'Kommunikatioun mat de Stakeholder, d'Gewährleeschtung, datt Erwaardunge erfëllt ginn, d'Deele vum Dokument um Site oder Intranet, an d'periodesch Iwwerpréiwung vun der Aarbecht, besonnesch wann relevant Ännerunge geschéien.

Beispillantwert: Mir wëllen, datt all ADR ëmmer eng primär Kontaktpersoun, eng sekundär Kontaktpersoun an en responsabelt Team huet; dës sinn zoustänneg fir Kommunikatiounen, Publikatiounen, Erhalung, periodesch Iwwerpréiwung op d'mannst eemol d'Joer, an eventuell Ausleeë wéi néideg.

Wéi interagéiert d'Governance mat engem ADR?

Berécksiichtegt Beräicher wéi d'Aarbechtsweise vun Ärer Organisatioun, speziell Compliance-Besoinen, zum Beispill fir juristesch Aspekter oder Personalaspekter, wéi Dir mat Konsens versus Konflikt versus Eskalatioun wëllt ëmgoen. Gëtt et Beräicher oder Persoune oder Teams, déi méi Afloss wéi anerer op en ADR kënne hunn, zum Beispill en genehmege kënnen, doriwwer ofstëmme kënnen oder en Veto asetze kënnen?

Beispillantwert: D'Governance vun engem ADR ass an dëser Prioritéitsuerdnung: de CEO, de CTO, de CLO, d'Team, dat en ADR ëmsetzt, d'Expert am Team, déi sech am beschten mat der AD auskennen. Keen anere huet Governance, ausser et ass am ADR beschriwwen.

Wéi eng Prinzipie interagéieren mat engem ADR?

Berécksiichtegt Beräicher wéi d'Aarbechtsweise vun Ärer Organisatioun, déi schnell Beweegung versus lues Beweegung enthalen, fir Decisiounskonsens versus Decisiounskonflikt, a fir Risikopräferenzen versus Sécherheetspräferenzen, ëffentlech Diskussioun versus privat Diskussioun an Ähnleches.

Beispillantwert: Mir benotzen d'Leadership-Prinzipie vum Bias for Action, Disagree-and-Commit, 70%-Schätzunge si gutt genuch fir einfach réckgängeg ze maachen an einfach isoléierbar Decisiounen, an ëffentlech Aarbechtsweisen mat der Ausnam vu vertraulecher Informatioun, wéi se an der Vertraulechkeetsvereinbarung vun eiser Organisatioun beschriwwen ass.