Centrale documentatie van architectuur in IRN

Background

Voor het inzichtelijk maken van de architectuur van IRN en dit zodanig ook te kunnen gebruiken als sturingsinstrument, is het noodzakelijk dat er een centrale plek komt voor het documenteren van de architectuur, de technisch ontwerpen, informatie over dienstverlening/aansluitvoorwaarden en notulen van architectuuroverleggen.

Op dit moment is dit niet gestandaardiseerd en maakt dit de informatievoorziening hiervoor sub-optimaal.

Considerations

To be filled in by the decision owner.

• Afspraken die zijn gemaakt met de enterprise architectuur. 
• Toegankelijkheid van de documentatie.
• Mogelijkheden voor het automatiseren van het beheer van de documentatie en de documentatie zelf.
• Veilige plaats voor documentatie.

Related Architectural Items

To be filled in by the decision owner.

• Met het werken onder architectuur moet er ook worden gekeken naar de tooling die hiervoor beschikbaar is. In dit geval is voor documentatie deze ABB en SBB beschikbaar:
  
  • ABB: Kennismanagement
  • SBB: Confluence - Jira

Rationale

To be filled in by the one who made the decision.

• De noodzaak voor een centrale plek voor documentatie is aanwezig.
• Er is in de architectuur een bouwblok voor kennismanagement aanwezig.
• Het bouwblok kennismanagement voldoet aan de eisen van de afwegingen (considerations). 
• Dus wordt de solution bouwblok van de ABB kennismanagement hiervoor ingezet. 
• Er mist nog 1 afweging die zo niet wordt ingevuld, dat gaat over de afspraken met de enterprise architectuur. Die vragen om de architectuur te modelleren in Sparx/Enterprise Architect.
  • Hiervoor is besloten dat dit nog steeds gebeurd, maar dat uiteindelijk die modellen doorlinken naar Confluence. Daar staat de documentatie.
  • In eerste instantie werkt IRN naar een complete set aan documentatie toe, daarna worden de onderdelen gemodelleerd in Sparx.
  • Individuele architecten mogen dit ook andersom doen (wat logischer kan zijn), maar die worden gehouden aan de documentatie in Confluence. 

Action items

1 incomplete Type your task here. Use "@" to assign a user and "//" to select a due date.