Skip to content

ADR-002 - De bron van de principes staat in Github, afgeleide set in BlueDolphin

Datum: 7-7-2023

Status

Geaccepteerd

Besluit

We leggen de set van Architectuurprincipes en Implicaties vast in de Github repository. Dit biedt meer mogelijkheden om de principes als document of als wiki website te publiceren.

Het vastleggen buiten BlueDolphin geeft ook de mogelijkheid om de principes 'formeel' te modelleren via RDF/Shacl.

Context

We gebruiken BlueDolphin als repository voor Architectuur schetsen. In die context willen we de principes ook graag kunnen gebruiken, maar we willen de gehele set aan Architectuurprincipes en Implicaties ook als document of website kunnen publiceren. En we willen de principes en implicaties ook graag transparant via versiebeheer kunnen beheren.

Alternatieven

  • Principes als office document vastleggen. Dit hebben we hiervoor gedaan in word en powerpoint en dat werkt best goed, echter documenten zijn lastig vindbaar wat het gebruik van het princpe raamwerk bij het nemen van beslissingen afremt.
  • Principes in de architectuur repository BlueDolphin vastleggen. Dit is afgevallen omdat BlueDolphin geen mogelijkheid biedt de principes als document of als wiki te publiceren.

Consequenties

We leggen de bron van de Architectuurprincipes buiten BlueDolhin vast en nemen ze daarnaast over in BlueDolphin voor gebruik in Architectuur schetsen. Dit levert een kleine extra beheerlast op.

De nieuwe API van BlueDolphin gaat mogelijk uitkomst bieden om de principes en implicaties automatisch te importeren vanuit de github bron.