Documentatie beschrijft hoe iets werkt of in elkaar zit.

Dat is vaak niet duidelijk. Het komt ook veel voor dat het helemaal niet bekend is dat er documentatie bestaat.

Als er 'agile' wordt gewerkt is het belangrijk dat het resultaat (een opgeleverd product) doet wat werd gespecificeerd.

Ontwikkelteams zeggen: 'We maken werkende software en dat hoeft niet gedocumenteerd te worden'.

Deze stelling klopt op zich wel. Want werkende software doet wat is gespecificeerd. Dat staat bijvoorbeeld in de acceptatie criteria. Ook de samenhang van de software blijkt uit een model dat hoort bij de informatieanalyse.

De documentatie is al gemaakt voordat met de realisatie wordt begonnen. Dit vereist wel dat de software realiseert wat is gedefinieerd.