Documentatie verbeteren - Scope en doelen

< Verbeteren van FO documentatie

Introductie

 * Stap voor stap
 * Probeer niet in één keer alle documentatie te verbeteren.
 * Maak een stap-voor-stap-plan.
 * Richlijnen
 * Start in fase 1 bijvoorbeeld met het bespreken van de richtlijnen.
 * Zorg dat alle FO-ers de richtlijnen kennen.
 * Op welke manier wil je e.e.a. gaan documenteren? Microsoft Word is soms minder geschikt om een systeem in te documenteren. Het kan slimmer zijn om te kiezen voor een modern CMS in combinatie met een EM-tool.
 * Wanneer het systeem is opgebouwd uit services, dan kun je de WSDL's als basis voor je documentatie gebruiken. In een WSDL staan namelijk de input- en output parameters. Heb je het dan over use case realisatie?
 * Welke services behoren tot de scope? Wanneer je een project uitvoert, dan zul je slechts een beperkt aantal services raken. Wil je je beperken tot alleen de nog-aan-te-raken-services? Of ga je op een gegeven moment alle services in scope trekken?