designdokumenter

Designdokumenter er formelle dokumenter som brukes i produkt- og programvareutvikling for å beskrive hvordan et system eller en komponent skal utformes for å møte gitte krav. De fanger designmål, valgte løsninger, begrensninger og forutsetninger, og fungerer som en referanse for videre arbeid og som grunnlag for vurderinger og godkjenning.

Et designdokument beskriver ofte arkitektur og moduloppdeling, grensesnitt og API-er, datamodeller og strukturer, samt algoritmer og kontrollflyt. Det inkluderer også ikke-funksjonelle krav som sikkerhet, ytelse, pålitelighet, skalerbarhet og vedlikeholdbarhet, samt avgrensninger, avveininger mellom alternativer og beslutningsgrunnlag (designrasjonale).

Dokumentet inngår i designfasen og er vanligvis underlagt iterasjon i samspill med kravspesifikasjon, implementering og testing. Det brukes i designmøter for å få godkjenning fra interessenter, og som referanse for utviklere, testere og driftspersonell. God dokumentasjon legger til rette for sporbarhet mellom krav og gjennomføring samt senere vedlikehold.

Det finnes ulike typer designdokumenter avhengig av domene, for eksempel software design document (SDD), systemdesign-dokumenter, hardware-design, eller brukeropplevelse og grensesnittdesign. I større prosjekter kan det også være en beslutningslogg for design samt designrasjonale som fanger beslutninger og begrunnelser gjennom prosjektet.

Designdokumenter anses ofte som levende dokumenter som oppdateres i takt med designendringer og implementasjon. De bør være sporbare til kravene og i samsvar med relevante standarder og kvalitetsprosesser. Når systemet implementeres og driftes, kan dokumentene suppleres med beskrivelser som dekker den faktiske, as-built-arkitekturen.