Richtlijnen voor duurzame beslissingen

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Tijdens ons werk hebben we de volgende lessen geleerd, die kunnen worden gebruikt als richtlijnen en evaluatiecriteria om duurzame beslissingen te bereiken:

Gebruik een lean/minimalistische aanpak voor de initiële documentatie van beslissingen.
Geef prioriteit aan en leg alle belangrijke beslissingen vast die relevant genoeg zijn om de doelarchitectuur te documenteren en te begrijpen.
Werk met name belangrijke beslissingen pas uit in een volwaardig sjabloon na het initiële werk (dat wil zeggen wanneer de besluitvormers tevreden zijn met de genomen architectuurbeslissingen en er vertrouwen is dat deze beslissingen niet snel hoeven te worden herzien).
Gebruik de lean/minimalistische versie van stap 1 als samenvatting van beslissingen die op een passend granulariteitsniveau zijn gedocumenteerd, om een overzicht van de gedetailleerde beslissingen te geven en ook voor triviale of vanzelfsprekende beslissingen.
Maak waar mogelijk gebruik van bestaande architectuurkennis, of het nu gaat om leidende modellen of andere bronnen. Beoordeel en breid die kennis uit en pas haar aan de context van de specifieke beslissingen aan.
Zorg ervoor dat er traceerbaarheidslinks worden gelegd tussen beslissingen en zowel eisen als architectuurontwerp/code.
Zorg voor geautomatiseerde consistentiecontroles zodat traceerbaarheidslinks na wijzigingen gesynchroniseerd blijven. Beperk het aantal afhankelijkheden tussen beslissingen en andere softwareartefacten.
Pas richtlijnen voor onderbouwing consistent en sterk toe. De onderbouwing is het belangrijkste deel van de beslissingsdocumentatie, omdat zij de reden geeft.