Wie kan ADR's schrijven?

Overweeg gebieden zoals specifieke personen, specifieke rollen, specifieke teams, specifieke afdelingen. Overweeg ook of er personen, rollen, teams of afdelingen zijn die ADR's kunnen laten maken, dat wil zeggen kunnen vragen dat iemand anders een ADR schrijft.

Voorbeeldantwoord: iedereen in onze organisatie die de README-pagina over architectuurbeslissingsdocumenten heeft gelezen, kan een ADR voorstellen, dat wil zeggen beginnen met schrijven en delen met het team.

Wat rechtvaardigt het indienen van een ADR?

Overweeg gebieden zoals hoe teams in de organisatie werken, de structuur van softwaresystemen, coördinatie tussen teams, onderhoudbaarheid op lange termijn, externe interfaces en wie je wilt laten profiteren.

Voorbeeldantwoord: we willen een ADR schrijven wanneer we willen dat toekomstige ontwikkelaars het "waarom" achter wat we doen begrijpen.

Wat rechtvaardigt het niet indienen van een ADR?

Overweeg gebieden zoals beslissingen die niet over architectuur gaan, beslissingen die triviaal zijn omdat ze minimaal risico hebben, op zichzelf staan of beperkt zijn tot één ontwikkelaar, beslissingen die al elders volledig worden behandeld in standaarden, beleid, documentatie enzovoort, of beslissingen die tijdelijk zijn, zoals noodoplossingen, proofs of concept en experimenten.

Voorbeeldantwoord: we willen een ADR overslaan wanneer de beslissing beperkt is in reikwijdte, tijd, risico en kosten, of al elders wordt behandeld.

Wat is de levenscyclus van een ADR?

Overweeg gebieden zoals het schrijfproces, het onderzoeksproces, het beslissingsproces, het implementatieproces en het uitfaseringsproces. Overweeg hoe je de levenscyclus van de ADR in de loop van de tijd volgt, bijvoorbeeld hoe je een ADR van de ene status naar de volgende verplaatst en hoe je dit aan belanghebbenden communiceert.

Voorbeeldantwoord: we willen dat ADR's vijf levenscyclusfasen hebben: Initiating → Researching → Evaluating → Implementing → Maintaining → Sunsetting.

Wat zijn de criteria voor de levenscyclusfasen van een ADR?

Overweeg gebieden zoals de acceptatiecriteria voor ADR's, dat wil zeggen hoe weten we dat een ADR goed genoeg is om van de ene levenscyclusfase naar de volgende te gaan? Is het probleem duidelijk beschreven? Zijn alternatieven overwogen? Zijn de afwegingen goed begrepen en gedocumenteerd? Is alle relevante context aanwezig? Zijn alle relevante belanghebbenden betrokken? Is alle feedback verwerkt?

Voorbeeldantwoord: we willen dat het actieve team 1) onderzoek afrondt, 2) evaluatie afrondt, 3) de ADR-voorstellen publiceert voor belanghebbenden met een verzoek om opmerkingen en een tijdslimiet van een week, en 4) wanneer alle opmerkingen van belanghebbenden zijn verwerkt en afgehandeld, laat belanghebbenden over de ADR stemmen.

Welke rollen en verantwoordelijkheden werken samen met ADR's?

Overweeg rollen zoals indiener, onderzoeker, evaluator, beoordelaar, goedkeurder en onderhouder. Overweeg verantwoordelijkheden zoals communiceren met belanghebbenden, ervoor zorgen dat verwachtingen worden waargemaakt, delen op de website of het intranet, en het periodiek herzien van het werk, vooral wanneer er relevante wijzigingen zijn.

Voorbeeldantwoord: we willen dat elke ADR altijd een primaire eigenaar, een secundaire eigenaar en een verantwoordelijk team heeft. Zij zijn verantwoordelijk voor communicatie, publicatie, onderhoud, periodieke herziening minstens jaarlijks en uiteindelijke uitfasering indien nodig.

Hoe werkt governance samen met ADR's?

Overweeg gebieden zoals hoe de organisatie werkt, speciale nalevingsbehoeften zoals juridische aspecten of HR-aspecten, en hoe je consensus versus conflict versus escalatie wilt behandelen. Zijn er gebieden, personen of teams die meer invloed kunnen hebben dan anderen, zoals de macht om goed te keuren, te stemmen of een veto uit te spreken in verband met ADR's?

Voorbeeldantwoord: de governance van een ADR volgt deze prioriteitsvolgorde: CEO, CTO, CLO, het team dat de ADR implementeert, de meest deskundige expert binnen het team over de ADD. Niemand heeft governance tenzij beschreven in de ADR.

Welke principes werken samen met ADR's?

Overweeg gebieden die te maken hebben met hoe de organisatie werkt, zoals snel of langzaam bewegen, beslissingsconsensus versus beslissingsconflict, risicovoorkeur versus veiligheidsvoorkeur, en openbare discussie versus privédiscussie.

Voorbeeldantwoord: we gebruiken de leiderschapsprincipes voorkeur voor actie (bias for action), het oneens zijn maar je committeren (disagree-and-commit), 70% van de informatie is genoeg voor beslissingen die gemakkelijk omkeerbaar en gemakkelijk te isoleren zijn, en openbaar werken, behalve voor vertrouwelijke informatie zoals beschreven in de geheimhoudingsovereenkomsten van onze organisatie.