Het documenteren van een softwarearchitectuur

In de praktijk blijkt het documenteren van softwarearchitectuur een stiefkindje te zijn. Al snel na de start van het project blijkt veel informatie in het document achterhaald, of snappen belanghebbende eigenlijk niet wat er staat omdat veel zaken te technisch verwoord zijn en er geen rekening is gehouden met hun kennis achtergrond. De IEEE 1471 standaard biedt mogelijkheden om een document te maken dat minder snel verouderd en dat voor diverse doelgroepen is geschreven. Ik heb inmiddels op die manier al een aantal softwarearchitectuur documenten geschreven en uit die ervaring kan ik zeggen dat het een grote hulp is.
 
Naast de standaard is er ook het boek Software Systems Architecture, Working with Stakeholders Using Viewpoints and Perspectives van N. Rozanski en E. Woods, dat erg behulpzaam is.