Dokumentere webprosjektet – Hva? Hvorfor? Hvordan?

Det finnes ingen standard for hvordan man skal jobbe med dokumentasjon av et webprosjekt. De fleste har litt ulik tilnærming, både når det gjelder innhold, ambisjoner og grundighet. Men de fleste av oss er enige om at dette er et stykke arbeid det ligger mye verdi i, og at dette bidrar til å skape bedre resultater. Min tilnærming er en ryddig beskrivelse av prosessen, og de avgjørelser og vurderinger som ligger til grunn for valgene som tas underveis i prosjektet.

Hvorfor er det så viktig å lage en god dokumentasjon?
Det finnes mange svar på dette. Her er eksempler på noen motivasjonsfaktorer:

Beslutningsgrunnlag og felles forventninger

Dokumentet bør brukes aktivt underveis i prosessen. Dermed fungerer det som et beslutningsgrunnlag for det gjenstående arbeidet. Vi er enige om definisjoner, føringer og forutsetninger som ligger til grunn. Dette er med på å sikre at vi har like forventninger til endelig løsning. Både for meg som leverandør og for kunden bidrar det til å skape en trygghet.

Vi lærer av våre feil

Uavhengig av om prosjektet er vellykket eller ikke så har du en grundig dokumentasjon på hvordan arbeidsprosessen har vært og hvilke utfordringer du har møtt på underveis. Å dokumentere denne erfaringen for hvert prosjekt gjør at du enkelt kan se hva som fungerer og ikke fungerer, og gjøre forbedringer som vil kunne skape bedre resultater.

Stille de viktige spørsmålene

Dokumentasjon underveis er med på å sikre struktur og ryddighet i arbeidet. De viktige spørsmålene blir stilt. Du har god oversikt over hvor langt du er kommet, og hva som gjenstår. Det er lettere å se hvilke konsekvenser det får om en forutsetning lagt tidlig i prosjektet endres.

Nye personer skal inn i prosjektet

Ved hjelp av en grundig dokumentasjon kan nye prosjektdeltagere enkelt sette seg inn i arbeidet som er blitt gjort. Vi har alle vært den som skal på et eksisterende prosjekt hvor du maser på alle om hvilke tanker som ligger til grunn, for likevel å møte på stadige overraskelser du ikke er blitt informert om.

Hva skal et slikt dokument inneholde?

Hva som skal dokumenteres avhenger av type prosjekt og hvilke steg det innebærer. Men om vi tar utgangspunkt i et standard webprosjekt som begynner med at kunden kommer til oss med en utfordring, og sluttproduktet er et nytt nettsted, så kan dokumentet innholde følgende:

Bakgrunn for prosjektet

Hvem er kunden?
Hvilke utfordringer har kunden?
Hvilke målsetninger har selskapet til kunden?
Hvilke målsetninger har kunden med nettstedet?

Brukere og bruksoppgaver

Hvilke målgrupper skal nettstedet nå?
Hvilke fellestrekk har de?
Hvilke forventninger har de?
Beskrivelse av brukerprofiler og tilhørende bruksoppgaver.
Resultat av brukertester, brukerintervjuer, spørreundersøkelser etc.

Hva skal løsningen inneholde?

Hva skal nettstedet tilby de definerte brukerprofilene?
Hvilke oppgaver har de behov for å løse?
Hva må være til stede for å løse kundens målsetninger?
Hvordan sikrer vi at innholdet tilfredsstiller ønsket kvalitet?
Alt innhold som må til for å besvare disse spørsmålene bør listes opp. Tekst, bilder, video, infografikk etc.

Kommunikasjonskonseptet

Hva er den overordnede ideen til nettstedet?
Hva er den røde tråden som skal gjennomsyre alt fra informasjonsarkitektur til grafisk design?
Hvilket hovedbudskap har vi til brukerne?
Hvordan skal dette implementeres i det visuelle, funksjonelle, strukturelle og i innholdet?

Informasjonsarkitektur

Hva skal navigasjon og struktur reflektere?
Hvordan skal dette bygges på en intuitiv måte?
Hva skal navigasjon bli trigget av?
Hvilket prinsipp skal ligge til grunn?
Hvordan skal innholdet struktureres I forhold til hverandre.
Hvilke relasjoner eksisterer?

Design

Hvilke innholdelementer skal være til stede?
Hvordan skal de vektes opp mot hverandre?
Hvordan skal interaksjon som feilmeldinger, lenker, skjema osv fungere?
Hvor fleksibelt skal malverket være?
Hva skal grensesnittet preges av?
I hvilken grad skal visuelle innholdselementer være med på å formidle budskapet?
Hvilke flater skal uttrykkes skapes for?
Hva med farger? Fonter? Videostil?
Hvilket etterlatt inntrykk skal brukeren sitte igjen med?

Funksjonelle krav

Hva trenger vi av funksjonalitet?
Språkhåndtering? SEO? Emnekart? Kampanjehåndtering? Arbeidsflyt? Søk? Print? Osv

Tekniske krav

Hvilken teknologi skal benyttes?
Hvilket CMS?
Hvilken versjon av HTML?
Hva med Wai krav?
Hva med flater?
Eller browserstøtte?

Dette er noe av innholdet som jeg legger med i denne type dokumentasjon.
Om det er andre som har synspunkter eller erfaringer de ønsker å dele så er jeg veldig spent på å høre fra dere.

Med ønske om en fantastisk sommerdag i den strålende solen :)