Tips til rapportskriving

Her er mine personlige tips til rapportskriving, basert på at jeg har lest veldig mange rapporter. Der får kanskje andre råd fra andre så dette er ikke noen fasit.

• Rapporten skal kunne gi informasjon til lesere med forskjellig bakgrunn.
  • Introduksjon og konklusjon skal kunne leses av alle. Mao. alle skal forstå i grove trekk hva oppgava går ut på, hvorfor den er viktig/relevant og hva slags resultat dere har kommet frem til. Starten på hvert hovedkapittel bør også være forståelig for alle.
  • Hoveddelen av rapporten bør skrives slik at en noenlunde teknisk kyndig person kan forstå den. Her kan dere f.eks. anta at leseren er en student som skal til å begynne på sin bacheloroppgave på ditt studium.
• Finn en fornuftig balanse mellom hovedkapitlene. Ikke fyll opp teoretisk grunnlag med masse unødig, dere får ikke uttelling for å ha mange sider og det som står under teoretisk grunnlag er ikke deres resultat og gir dermed ikke uttelling. Vi vet hva Java er osv. Bare ta med ting som oppfyller alle disse kriteriene:
  
  • Kunnskap du ikke kan forvente at leser allerede har.
  • Nødvendig for å forstå tekst som kommer senere (typisk i metode).
• Dokumentasjon av programvare som er anvendt ("tool chain") kan f.eks. være en tabell med programvare, versjonsnummer og en kort kommentar om hva dere bruker den til. Husk å gjøre det samme med evt. moduler, biblioteker og annet som dere installerer i tillegg til basisprogramvaren.
• Begynn hvert hovedkapittel med en liten introduksjon til hva som kommer nå og hvorfor det er relevant. Dette bør skrives slik at alle kan forstå hva kapittelet omhandler. Det hjelper dere til å få en rød-tråd i rapporten og det hjelper dere til å få på plass det som skal inn i kapittelet.
• Bruk skikkelige referanser. Ja jeg vet at det krever ekstra arbeid å finne ei bok eller en annen god kilde, men tilfeldige nettsider eller populærformidlere som "How Stuff Works" er ikke gode kilder. Er det grunnleggende teori så finnes det gode lærebøker, bruk dem. Er det mer avanserte ting så finner du publiserte tidsskriftartikler på nettet (tar bare litt mer tid å google under scholar.google.com. For øvrig anbefaler jeg at dere søker på oria.no. Men, ikke bruk tidsskriftartikler hvis det er grunnleggende ting som er dekt i gode lærebøker. Da foretrekker jeg sistnevnte fordi de har ofte bedre forklaringer og er mer utfyllende. 
  • Lær deg å sitere riktig. Det finnes nok av ressurser på nettet som viser hvordan det skal gjøres. Ikke risiker å bli tatt for fusk!
  • Ikke kopier deg selv, det er også plagiat (selvplagiat). Siterer heller det du tidligere har skrevet (se over).
  • Sjekk at du ikke kommer med påstander som ikke er belagt med referanser el.lign.
• Gammelt nytt, men fortsatt viktig:
  • Alle figurer, tabeller, bilder osv. skal omtales i teksten. Hjelp leseren til å forstå hensikten. "Som vist i figur xxx ...., legg spesielt merke til ....". Ut fra tabell yyy ser vi at ...., og for verdi ... ser vi at tilhørende ....".
  • Tegnsetting. Ett mellomrom etter punktum, komma, spørsmålstegn osv.
  • Orddeling (særskriving). Husk at ord som hører sammen på engelsk vanligvis skrives som to ord men skrives som ett ord på norsk. F.eks. "control panel" blir kontrollpanel på norsk. Anbefaler alle å bli medlem av Astronomer Mot Orddeling (AMO https://www.facebook.com/groups/2361395921/)
  • Føles setninga lang så er den sikkert for lang. Punktum er billig. Ikke vær redd for å dele opp kronglete setninger.
  • Alle grafer skal ha tittel og enheter på aksene.
  • Bruk et nøytralt språk. Pass på at teksten ikke blir barnslig eller i overkant muntlig. Det er også fare for å bli for formell og oppstyltet. Både "man ser at", "vi fant at" og til og med "når jeg inverterte .." er OK.