Recent changesContact the site administrator
Home
HoeveelDocumentatieIsNodig
Uit de discussie op XP-nNL 1_1 kwam het volgende naar voren:

Als ontwikkelaar heb je in ieder geval WEL nodig:

* de code (zo zelf-documenterend mogelijk) MET unit-tests

* de aanwijzingen voor de ontwikkelaar van de oorspronkelijke bouwers

* API-documentatie

* een overzicht op hoog niveau wat de applicatie doet (conceptueel model / componenten model))

* release notes. Aan de hand hiervan liet Rutger een demo zien van hoe de releasenotes uit de project-WIKI direct naar voren kwamen. Ook liet Marco een demo van JIRA zien. JIRA en de project-WIKI doen op hoofdlijnen hetzelfde.

Als ontwikkelaar heb je NIET nodig:

* de gebruikers-documentatie

* het analysemodel

* technische documentatie

Verder werd aangestipt dat je misschien andere eisen aan de doucmentatie stelt als je beheer bestaat uit bugfixing of als je beheer bestaat uit adaptief onderhoud.

Informatie Brains4all