32 Prosjektarbeid og dokumentasjon

Fra idé til ferdig produkt

Du har sikkert hatt en god idé til noe du ville bygge -- en sensor, en robot, en dings. Men veien fra idé til ferdig produkt er full av feller: du undervurderer tiden, glemmer å bestille en komponent, eller ender med noe som virker, men som ingen andre forstår. Det er nettopp her prosjektarbeid kommer inn -- den disiplinerte måten å føre en idé trygt i mål på.

I dette kapittelet skal vi lære hvordan profesjonelle gjennomfører tekniske prosjekter. Vi starter med de fire fasene ethvert prosjekt går gjennom, og møter prosjekttrekanten -- en slags jernlov som forteller hvorfor du ikke kan få alt. Deretter ser vi på verktøyene som holder orden på arbeidet, fra Gantt-diagram til Kanban-tavle. Så går vi gjennom den tekniske dokumentasjonen som gir prosjektet varig verdi, og til slutt hvordan du skriver en god rapport og presenterer arbeidet ditt. For et prosjekt er ikke ferdig når dingsen virker -- det er ferdig når noen andre kan forstå, bruke og bygge videre på det.

De fire fasene og en jernlov

La oss først definere hva et prosjekt er: en tidsbegrenset innsats for å oppnå et spesifikt mål, med et definert omfang, bestemte ressurser og konkrete leveranser. Ethvert prosjekt går gjennom fire faser. Den første er oppstart: definere mål og krav, identifisere interessentene, og vurdere om det i det hele tatt er gjennomførbart. Den andre er planlegging: bryte arbeidet ned i oppgaver, estimere tid og ressurser, lage en tidsplan, og kartlegge risiko. Den tredje er gjennomføring: utføre oppgavene, følge opp framdriften og håndtere endringer. Og den fjerde er avslutning: levere resultatet, dokumentere, evaluere og overføre til drift.

Midt i alt dette står en uunngåelig sannhet: prosjekttrekanten. Den består av tre hjørner -- tid, kostnad og omfang/kvalitet -- og det avgjørende er at de henger sammen. Endrer du ett, påvirkes de andre. Vil du levere raskere? Da må du enten bruke mer penger eller redusere omfanget. Vil du ha høyere kvalitet? Da trenger du mer tid eller mer penger. Du kan rett og slett ikke optimalisere alle tre samtidig. Dette er ikke pessimisme, men realisme -- og å forstå det gjør deg til en bedre planlegger.

For at målene skal være håndterbare, bruker vi gjerne SMART-mål: Spesifikt, Målbart, Oppnåelig (Achievable), Relevant og Tidsbegrenset. Et vagt mål som «lage noe kult» er ubrukelig. Et SMART-mål derimot -- «bygge en temperaturstyrt vifte som slår seg på over 25 °C, dokumentert med kretsskjema og brukermanual, ferdig 15. april» -- gir deg noe konkret å sikte mot og noe målbart å sjekke deg ferdig mot.

Verktøyene som holder orden

En god plan i hodet holder ikke når et prosjekt vokser. Da trenger du verktøy som gjør planen synlig. Det mest klassiske er Gantt-diagrammet -- en visuell tidslinje der hver oppgave er en horisontal søyle med start- og sluttdato. Det viser også avhengigheter mellom oppgaver (hva må gjøres før noe annet kan starte) og milepæler, som er viktige punkter som markerer at en fase er fullført.

For å bryte et stort prosjekt ned i håndterbare biter bruker vi en WBS -- Work Breakdown Structure. Det er en hierarkisk nedbrytning: prosjektet deles i faser, fasene i oppgaver, oppgavene i deloppgaver. Et byggeprosjekt kan for eksempel deles i Design, Bygging og Dokumentasjon, og hver av disse igjen i mindre biter som kravspesifikasjon, kretsdesign og testing. Når alt er brutt ned, blir det plutselig overkommelig.

Et annet populært verktøy er Kanban-tavla, som visualiserer arbeidsflyten i kolonner: «Å gjøre», «Pågår» og «Ferdig». Hver oppgave er et kort som flyttes mellom kolonnene. En viktig idé her er å begrense hvor mye som er i gang samtidig -- det som kalles WIP, work in progress -- så du faktisk får ting ferdig i stedet for å starte ti ting på én gang.

Til slutt hører risikoanalyse med i enhver god plan. Du identifiserer hva som kan gå galt, og vurderer det ut fra sannsynlighet ganger konsekvens. Et klassisk eksempel i elektronikkprosjekter: komponenter som ikke kommer i tide. Tiltaket er enkelt -- bestill tidlig. Ved å tenke gjennom risikoene på forhånd, slipper du de verste overraskelsene underveis.

Dokumentasjonen som gir arbeidet verdi

Nå kommer den delen mange undervurderer, men som ofte avgjør om et prosjekt blir verdifullt: dokumentasjonen. Hvorfor dokumentere? For kunnskapsoverføring, for å muliggjøre vedlikehold og reparasjon, for reproduserbarhet, og av juridiske og kontraktsmessige grunner.

Det finnes flere typer dokumentasjon. En kravspesifikasjon beskriver hva systemet skal gjøre -- funksjonelle krav, ytelseskrav, grensesnitt og begrensninger. En teknisk spesifikasjon beskriver hvordan det er bygd -- arkitektur, komponentvalg, kretsskjemaer og kode. En BOM (Bill of Materials) lister alle komponentene med referanse, verdi, leverandør og antall, slik at andre kan bestille delene og bygge det på nytt. En brukermanual retter seg mot sluttbrukeren, med installasjon, bruk og feilsøking. En testrapport dokumenterer at testingen er gjort. Og for elektriske installasjoner trengs en samsvarserklæring som bekrefter at forskriftene er fulgt.

Til slutt skal arbeidet ofte presenteres i en teknisk rapport. Den har en fast struktur: forside, sammendrag, innholdsfortegnelse, innledning med bakgrunn og mål, teori, metode, resultater, diskusjon, konklusjon, referanser og vedlegg. Sammendraget -- på rundt 100 ord -- er spesielt viktig, for det er ofte det eneste mange leser; det skal kort fortelle hva du gjorde, hva du fant, og hva det betyr.

Og så er det selve presentasjonen. Noen gode råd: kjenn publikummet ditt, strukturer logisk, bruk visuelle hjelpemidler, øv på forhånd, hold tiden, og forbered deg på spørsmål. Til skriving og presentasjon bruker du gjerne Word eller Google Docs, lysbilder, og Git for versjonskontroll. Husk: et prosjekt er ikke ferdig når det virker -- det er ferdig når noen andre kan forstå, bruke og bygge videre på det.

Oppsummering

Vi har lært å føre et prosjekt fra idé til ferdig produkt. Et prosjekt går gjennom fire faser -- oppstart, planlegging, gjennomføring og avslutning -- styrt av prosjekttrekantens jernlov: tid, kostnad og omfang henger sammen, og du kan ikke få alt. Gode mål er SMART: spesifikke, målbare, oppnåelige, relevante og tidsbegrensede.

Vi så verktøyene som holder orden -- Gantt-diagram, WBS, Kanban-tavle og risikoanalyse -- og deretter den dokumentasjonen som gir arbeidet varig verdi: kravspesifikasjon, BOM, brukermanual, testrapport og en teknisk rapport med fast struktur. Et sentralt poeng er at et prosjekt ikke er ferdig når dingsen virker, men når andre kan forstå, bruke og bygge videre på det. Med disse ferdighetene kan du gjennomføre tekniske prosjekter på en måte som varer.