reportzynk
← Ressurser
Dokumentasjon

Verktøyene vi bruker for å dokumentere en sluttgodkjenning

Marte Lindgren går gjennom hvilke enkle verktøy og arbeidsmetoder som gjør sluttgodkjenningen sporbar: loggark, versjonsmerking og arkivmappe som alle i teamet forstår.

Marte Lindgren

5 min lesetid

Verktøyene vi bruker for å dokumentere en sluttgodkjenning

Begynn med et loggark, ikke et program

Når jeg underviser i sluttgodkjenning, starter jeg nesten alltid med det samme: et enkelt loggark. Det kan være et regneark eller et vanlig dokument i prosjektmappen. Poenget er ikke verktøyet, men at hele teamet vet hvor godkjenningen står skrevet ned. Mange virksomheter har kommentarer spredt over e-post, chat og møtenotater, og når produksjonen er ferdig finnes det ingen samlet fortelling om hva som ble besluttet.

Loggarket vi bruker i kurset har få kolonner og er laget for å fylles ut raskt. Det som ikke blir fylt ut i løpet av en arbeidsdag, blir som regel aldri fylt ut. Derfor holder vi det kort og lar hver rad beskrive én beslutning. Verktøyet skal være så lite at ingen unnskylder seg med at det tar for lang tid.

  • Ett loggark per prosjekt, lagret sammen med filene
  • Én rad per beslutning, ikke per kommentar
  • Samme oppsett i alle prosjekter

Hva som skal loggføres ved siste runde

Den siste revisjonsrunden er der de fleste skjønner at dokumentasjon mangler. Jeg anbefaler å loggføre fem ting: hvilken versjon som ble vurdert, hvem som hadde avgjørelsesmyndighet, hvilke kommentarer som ble innarbeidet, hvilke som ble avvist og hvorfor, og tidspunktet for godkjenningen. Avviste kommentarer er den delen som oftest glemmes, men den er nyttig når noen senere spør hvorfor en endring ikke ble gjort.

Begrunnelsen trenger ikke være lang. En setning er nok, for eksempel at kommentaren lå utenfor avtalt omfang eller at den ble besluttet av prosjekteier. Det viktigste er at navnet på den som avgjorde står ved siden av. Da blir loggen en rolig referanse i stedet for et utgangspunkt for diskusjon.

  • Versjonsnavn og dato for den godkjente filen
  • Navn på den som godkjente
  • Innarbeidede og avviste kommentarer med kort begrunnelse

Versjonsmerking som holder over tid

Et loggark er lite verdt hvis filene ikke kan knyttes til det. Derfor lærer vi bort en fast navnestandard der prosjektnavn, versjonsnummer og status står i filnavnet. Den godkjente filen får et tydelig merke, og alle tidligere versjoner flyttes til en egen undermappe i stedet for å slettes. Slik kan man alltid gå tilbake og se hva som faktisk ble vist til hvem.

Vi ber deltakerne unngå navn som endelig, endelig2 og endeligbrukdenne. De fungerer de første ukene, men er ubrukelige et halvt år senere. Et nummerert system tar litt lengre tid første gang, men sparer mye leting når noen ber om filen igjen etter lang tid.

Hvordan godkjenningen bekreftes

Mange spør om godkjenningen må signeres på papir. Det er ikke nødvendig for de fleste interne prosjekter. Det viktige er at bekreftelsen kan spores til en person og en versjon. En kort e-post fra den ansvarlige, med versjonsnavn i emnefeltet og en tydelig setning om at filen er godkjent, fungerer godt. Den lagres som PDF i prosjektmappen ved siden av loggarket.

Der prosjektet involverer flere parter, for eksempel en ekstern byrå og en intern oppdragsgiver, anbefaler jeg at begge bekrefter skriftlig. Det tar to minutter og fjerner usikkerheten om at noen trodde noe annet. Vi øver på denne formuleringen i kurset, slik at den blir en vane og ikke en formalitet man utsetter.

Arkivering som andre kan finne frem i

Arkivet er der dokumentasjonen enten blir nyttig eller forsvinner. Vi foreslår en mappestruktur som er lik fra prosjekt til prosjekt: ferdig fil, godkjenningsbevis, loggark og tidligere versjoner. Den som åpner mappen to år senere skal forstå innholdet uten å ringe noen. Det er den enkleste testen jeg kjenner på om arkiveringen er god nok.

Vi snakker også om oppbevaringstid. Hvor lenge skal materialet ligge, og hvem har ansvar for å rydde? Svaret avhenger av virksomhetens egne rutiner, og det er greit. Det viktige er at noen har fått ansvaret og at det står i prosjektdokumentene, slik at arkivet ikke vokser uten kontroll.

  • Fast mappestruktur i alle prosjekter
  • Navngitt ansvarlig for arkivet
  • Avtalt oppbevaringstid noteres i loggen

Små rutiner som holder verktøyene i live

Verktøy som ikke brukes blir fort pynt. Derfor avslutter jeg kurset med å se på hvordan rutinen kan bygges inn i hverdagen. En fem minutters gjennomgang av loggarket før filen leveres til kunden fanger de fleste hull. Noen team legger den inn som siste punkt i sjekklisten for levering, og det fungerer godt fordi den da ikke er avhengig av at noen husker den.

Det er også verdt å la én person eie malen. Når alle justerer den litt på egen hånd, blir loggene forskjellige og vanskelige å sammenligne. Ved å samle endringer hos én ansvarlig holder dere formatet stabilt, og nye medarbeidere lærer det raskere.

God sluttgodkjenning handler mer om vane enn om utstyr. Et loggark, en fast navnestandard, en skriftlig bekreftelse og en ryddig arkivmappe dekker det aller meste. Verktøyene er enkle med vilje, slik at de faktisk brukes når fristen presser. Begynn med ett prosjekt i høst, se hva som mangler, og juster malen derfra.

Om forfatteren

Marte Lindgren

Instruktør, dokumentasjon

Arbeider med maler, versjonering og sluttdokumentasjon. Viser hvordan små rutiner gir mindre rot i prosjektet.

Les også

  1. Hva «prosesseier» betyr i en videogjennomgang, forklart enkelt

    En prosesseier er den som holder gjennomgangen sammen fra første utkast til godkjent versjon. Slik skiller du rollen fra den som kommenterer og den som avgjør.

  2. Vanlige feil i revisjonsrunder og versjonsnavn, og hvordan du unngår dem

    Fem feil som går igjen når team gjennomgår video i flere runder, fra uklare versjonsnavn til runder uten slutt, og hva du kan gjøre med hver av dem.

  3. Fast antall runder eller åpen revisjon: to måter å styre versjoner på

    Vi sammenligner to måter å organisere revisjonsrunder og versjonsnavn i videoprosjekter, og forklarer hvilken vi anbefaler til team som vil ha færre misforståelser.

reportzynk

Ryddig gjennomgang og trygg godkjenning

Tyholmsveien 14, 4836 Arendal+47 37 02 41 58[email protected]