Användningen och nyttan av systemdokumentation

Abstract

Många är överens om vikten av att dokumentera vid systemutveckling. Systemdokumentation av god kvalitet är till stor hjälp när ett system skall underhållas och vidareutvecklas, dessutom är det ett utmärkt sätt att förbättra kommunikationen under systemutvecklingsarbetets gång. Men när utvecklingen är klar, dokumentationen skriven och projektet avslutat, vad händer då? Används systemdokumentationen? Det verkar finnas en utbredd allmän uppfattning dels att systemutvecklare inte tycker om att skriva dokumentation men också att det bland systemutvecklare finns en inbyggd aversion mot att läsa densamma. Syftet med denna studie var att belysa användandet av systemdokumentation med utgångspunkt från systemutvecklarna. Studien byggde på individuella djupintervjuer med systemutvecklare på fyra olika IT-företag. Studien visade att systemdokumentationen används, dock inte i någon större omfattning, istället används andra informationskällor, t.ex. muntlig information eller källkod. Detta beror på att tillgängligheten till systemdokumentationen ofta är dålig och att nyttan av systemdokumentationen upplevs som liten. Studien visade bl.a. på att de främsta orsakerna till detta var att systemdokumentationen till form och innehåll inte är anpassad för den tilltänkta användaren (systemförvaltaren) och att tillgängligheten till systemdokumentationen försämras av att man inte skiljer på projektdokumentation och produktdokumentation (systemdokumentation), varken rent fysiskt eller konceptuellt. ,