Produktdokumentasjon
Produktdokumentasjon skal tydelig beskrive hva prosjektet skal levere, hvilke krav som gjelder, og hva som må være oppfylt for at produktet kan godkjennes og tas i bruk.
Produktdokumentasjonen bør være nyttig både for prosjektet, prosjekteier, brukere, linjeorganisasjonen og eventuelle leverandører. Den skal bidra til felles forståelse av hva som skal utvikles, endres, innføres, driftes eller forvaltes.
Produktdokumentasjonen bør avklare:
- Hva produktet er
- Hvilket behov produktet skal dekke
- Hvem som skal bruke, eie, drifte eller forvalte produktet
- Hvilke krav som gjelder
- Hvilke akseptansekriterier som skal brukes
- Hvordan produktet skal testes eller vurderes
- Hvilke avhengigheter produktet har
- Hvordan produktet skal overleveres til linje, drift, forvaltning eller produktteam
Produktbeskrivelse
En produktbeskrivelse er den viktigste delen av produktdokumentasjonen. Den bør beskrive produktet på et nivå som er nyttig for styring og gjennomføring.
I prosjekter som bruker smidige arbeidsformer, kan produktdokumentasjonen bestå av en kombinasjon av overordnede produktbeskrivelser, produktkø, brukerhistorier, akseptansekriterier, beslutningslogger, testresultater og annen dokumentasjon som viser hva som er utviklet og hvorfor.
Produktdokumentasjonen trenger ikke alltid være ett samlet tekstdokument. Den kan ligge i et system for produktstyring, i en produktkø, i arkitekturverktøy, i testverktøy, i regneark eller i andre løsninger. Det viktigste er at informasjonen er oppdatert, tilgjengelig og sporbar.
Akseptansekriterier
Akseptansekriterier definerer hva som er akseptabelt og ikke akseptabelt opp mot prosjektets styringsparametere.
Kriteriene bør knyttes til tid, kostnad, kvalitet, omfang, bærekraft, nytte og risiko der det er relevant. De bør beskrives med målbare størrelser eller tydelige vurderingskriterier så langt det lar seg gjøre.
For produktdokumentasjonen betyr dette at krav og produktbeskrivelser ikke bare skal forklare hva som skal leveres, men også hva som må være oppfylt for at leveransen kan godkjennes innenfor prosjektets rammer. Se mer om styringsparametere og akseptansekriterer:
Overlevering og videre bruk
Produktdokumentasjonen skal støtte overlevering til linjeorganisasjonen, drift, forvaltning eller produktteam.
Før prosjektet avsluttes, bør det være tydelig:
- Hvilken dokumentasjon som følger produktet
- Hvem som overtar ansvar
- Hvilke krav, vurderinger og beslutninger som ligger til grunn
- Hvilke åpne punkter eller gjenstående arbeid som må følges opp
- Hvordan produktet skal videreutvikles, driftes eller forvaltes