Documentatie verbeteren


 * Domein: Documentatie
 * Programma: Continu verbeteren
 * Team(s): Team A
 * Vakgroep: FO vakgroep
 * Zie ook: Professionalisering van vakgroepen

Introductie

 * In de meeste organisaties is de documentatie niet op orde. De documentatie is niet up-to-date, inconsistent, ontwerprichtlijnen zijn er niet of niet bekend bij de professionals die documentatie maken.
 * Een complex systeemlandschap wil je niet middels Microsoft Word documenteren.
 * Het is een good practice om een vakgroep op te zetten waar alle FO-ers in particperen en een plan te gaan maken om enterprise modelling te introduceren.

Volgende mogelijke acties

 * Ontwerprichtlijnen
 * Vandaag wil T één pagina maken voor de validaties. Moeten we nog meer ontwerprichtlijnen evalueren om straks de documentatie te kunnen verbeteren? Heeft iedereen bijvoorbeeld weet van hoe we naar het generieke validatie document verwijzen.
 * WSDL importeren
 * T dacht dat hij gisteren met P de WSDL ging importeren, maar dat is op een ander moment.
 * Meldingen
 * J gaf gisteren aan dat we de meldingen wellicht als eerste in EA kunnen zetten. J gaat een subtaak aanmaken. Volgende week tijdens het team overleg laten zien hoe e.e.a. in EA gezet kan worden.
 * Projectplan
 * Deze week wilden we een eerste opzet van een projectplan hebben.
 * Is het een idee om voor donderdag een meetup in te plannen met B, J en T om vragen en/of volgende acties te bespreken?
 * Hoe loopt de merge? Waar lopen we tegen aan? Kunnen we nog ergens hulp vragen?

On our mind

 * EA huiswerkopdracht 1
 * Scope

Nog verwerken

 * Niet zelf gaan documenteren, maar zorgen dat het hele team aandacht gaat besteden aan documentatie. De perfecte aanleiding om deze ambitie op de agenda te krijgen is op het moment dat er m.b.t. een omvangrijke wijziging of vanuit een project e.e.a. overgedragen moet gaan worden naar de beheerorganisatie. Zie Overdracht naar beheer.

Index

 * Actielijst