{"canonical_url":"https://engineer.company/nb/glossary/code-review/","content_markdown":"# Kodegjennomgang\n\n## Hva det er\n\nEn kodegjennomgang er steget der noen andre enn forfatteren leser en endring før\nden blir en del av kodebasen. Googles veiledning om selskapets utviklingspraksis\ndefinerer det som en prosess der noen andre enn kodens forfatter eller\nforfattere undersøker koden, og kapitlet om emnet i _Software Engineering at\nGoogle_ legger til at dette ofte skjer før koden føres inn i kodebasen. Mange\nnorske utviklere bruker også det engelske code review, og ellers avhenger\nnavnet mest av verktøyet. På GitHub er det en pull request-gjennomgang, hos\nGoogle en precommit-gjennomgang, og i Linux-kjernen skjer det over e-post, der\nen gjennomgåer som er fornøyd med en patch, tilbyr en Reviewed-by-tag til den.\n\nGoogles veiledning lister opp hva en gjennomgåer ser etter: design,\nfunksjonalitet, kompleksitet, tester, navngiving, kommentarer, stil og\ndokumentasjon. Bak hvert ord ligger et spørsmål. Oppfører koden seg slik\nforfatteren sannsynligvis mente, og er den oppførselen god for brukerne? Kunne\nden vært enklere? Følger det med korrekte og godt utformede automatiske tester?\nHar forfatteren oppdatert dokumentasjonen som beskriver den?\n\nMekanikken er stort sett den samme overalt. Forfatteren sender en diff med en\nbeskrivelse, gjennomgåerne kommenterer enkeltlinjer, forfatteren svarer eller\nlaster opp en ny versjon, og runden gjentas til en gjennomgåer godkjenner\nendringen. Hos Google kalles godkjenningen LGTM, en forkortelse for _looks good\nto me_, og boken beskriver den som en tillatelsesbit: som standard kreves bare\nén LGTM, og sammen med godkjenning fra en kodeeier og en readability-kontroll\ngir den lov til å committe endringen. GitHub avslutter hver gjennomgang med én\nav tre avgjørelser. Comment gir generell tilbakemelding uten å godkjenne eller\nbe om endringer, Approve signaliserer at endringene er klare til å flettes inn,\nog Request changes markerer tilbakemeldinger forfatteren bør ta tak i før\ninnflettingen. Alle med lesetilgang kan gjennomgå og kommentere, og\nadministratorer av et repo kan kreve godkjenninger før en pull request flettes\ninn. Googles veiledning kaller hver endring en CL, og derfor heter en av sidene\nSmall CLs.\n\n## Hvorfor det er viktig\n\nBoken nevner seks fordeler ved en velfungerende kodegjennomgang. Den\nkontrollerer at koden er korrekt, sørger for at andre utviklere forstår\nendringen, holder kodebasen konsistent, fremmer felles eierskap i teamet, sprer\nkunnskap og etterlater en historisk oversikt. Korrekthet er den åpenbare, og\nforfatterne viser til en studie hos IBM, publisert i 1986, som fant at feil som\nble oppdaget tidligere, tok kortere tid å rette. Boken legger til betingelsen\nsom teller: tiden som ble brukt på gjennomgang, lønte seg bare så lenge\nprosessen forble lett. Statisk analyse og automatiske tester bærer i dag mye av\nkorrekthetsarbeidet, og ifølge boken har det redusert behovet for å la mennesker\nstå for det.\n\nForståelse er fordelen verktøyene ikke tar over. En gjennomgåer kan gjøre det\nselv den beste utvikleren ikke kan gjøre med sitt eget arbeid, nemlig lese det\nuten forfatterens perspektiv, og en gjennomgang er ofte den første prøven på om\nen endring gir mening for andre. Det betyr noe fordi kode blir lest mange flere\nganger enn den blir skrevet. De kulturelle fordelene er mer stillferdige.\nGjennomgangen minner utvikleren på at koden ikke er ens egen, men en del av et\nfelles foretak, den lar eksperter gi videre det de kan om et område, og fordi\nhver endring beholder sin gjennomgang, kan alle senere finne ut når et mønster\nkom inn, og lese gjennomgangen som brakte det med seg.\n\nKodegjennomgang koster også tid, og treg gjennomgang koster mer. Googles\nveiledning om hastighet sier at når gjennomgangene er trege, faller tempoet i\nhele teamet, utviklerne begynner å protestere mot prosessen, og kodehelsen\nlider, fordi det oppstår press for å slippe svakere endringer gjennom, og\nopprydding blir motarbeidet. De fleste klager på at en gjennomgåer er for\nstreng, forsvinner ifølge veiledningen når den samme gjennomgåeren bare svarer\nraskere. Standarden for godkjenning er pragmatisk: gjennomgåere bør heller\ngodkjenne en endring når den helt klart forbedrer den samlede kodehelsen i\nsystemet, selv om den ikke er perfekt. Veiledningen kaller dette det\noverordnede prinsippet blant reglene sine og samler begrunnelsen i én linje:\n«det finnes ikke perfekt kode – det finnes bare bedre kode».\n\n## Slik ser det ut i praksis\n\nTenk deg en nettbutikk der prisene føres i hele øre. En forfatter legger til en\nvårkampanje og sender denne endringen til gjennomgang:\n\n```diff\n--- a/shop/pricing.py\n+++ b/shop/pricing.py\n@@ -8,2 +8,4 @@ def order_total(basket):\n     subtotal = sum(line.price * line.quantity for line in basket.lines)\n+    if basket.voucher == \"SPRING\":\n+        subtotal = subtotal * 0.9\n     return subtotal + shipping_for(basket)\n```\n\nGjennomgåeren legger igjen fire kommentarer:\n\n```text\nshop/pricing.py, linje 9\n  De andre rabattkodene og satsene deres ligger i VOUCHERS i\n  shop/vouchers.py. Kan SPRING flyttes dit også? Da blir neste\n  kampanje en endring i data, ikke i denne funksjonen.\n\nshop/pricing.py, linje 10\n  Prisene er hele øre overalt ellers i modulen, og å gange\n  med 0.9 kan gi en brøkdel av et øre. De andre rabattene\n  går gjennom round_money() i shop/money.py.\n\nshop/pricing.py, linje 11\n  Nit: frakten er ikke med i rabatten. Hvis det er med vilje,\n  vil en kort kommentar om det hjelpe neste leser.\n\nGenerelt\n  Det mangler en test med rabattkode i handlekurven. Kan du\n  legge til én for SPRING og én som viser at en ukjent kode\n    lar prisen være uendret?\n```\n\nHver kommentar handler om koden og ikke om personen, og hver av dem sier\nhvorfor. Den første, den andre og den siste har ingen merkelapp, så de\nforventes fulgt opp; den tredje begynner med Nit:, som Googles veiledning bruker\nom noe lite som forfatteren teknisk sett burde gjøre, men som ikke vil påvirke\nnoe særlig. Veiledningens andre merkelapper er Optional, eller Consider, for en\ngod idé som ikke er påkrevd, og FYI for en tanke forfatteren ikke forventes å\nhandle på i denne endringen. Uten merkelapper, advarer den, kan forfattere lese\nhver kommentar som et krav. På GitHub ender denne runden med Request changes.\nForfatteren flytter SPRING inn i tabellen, sender rabatten gjennom\navrundingsfunksjonen, legger til kommentaren og begge testene og ber om en ny\ntitt; andre runde ender med Approve, eller hos Google med LGTM. Veiledningen ber\ngjennomgåere svare på en forespørsel om gjennomgang innen høyst én arbeidsdag,\nog ikke avbryte en konsentrert oppgave for å gjøre det, men vente på en naturlig\npause.\n\nKommentarene handler verken om formatering, importrekkefølge eller om testene\nbestår, for det burde en maskin ha sagt før gjennomgåeren åpnet diffen. Boken\nbeskriver presubmits som kjører når en endring først sendes til gjennomgang, og\nsom kan avvise den før noen leser den; Linux-kjernen ber forfattere kjøre\nkjernens stilkontroll, `scripts/checkpatch.pl`, før de sender inn.\n[Kontrollmotoren som ble bygd for et repo](/nb/portfolio/built-a-268-check-guard-engine-for-the-repo/),\nfra 2025, tar den ideen langt: 268 registrerte commit-kontroller, 277\nlint-regler og 15 egne ESLint-regler, pluss 146 tester av selve kontrollene.\nKontrollene sjekker blant annet at en migrering kan rulles tilbake og at en\noversettelsesnøkkel finnes i begge språkversjonene, og enhver commit med\nprefikset fix: må ha med en test som feiler uten den. Kontrollene kodet inn mekaniske regler, slik at gjennomgåerne kunne bruke mer tid på design. Siden sier også\nhva det koster: det går tregt å committe, og en dårlig skrevet kontroll er\nvirkelig irriterende å jobbe seg rundt.\n\n## Hvor det går galt\n\n**Endringen er for stor til å lese.** Googles veiledning kaller 100 linjer\nvanligvis en rimelig størrelse for en endring og 1 000 linjer vanligvis for\nstort, men overlater vurderingen til gjennomgåeren, og den påpeker at 200\nlinjer i én fil kan være greit, mens de samme 200 linjene spredt over 50 filer\nikke ville vært det. Små endringer blir gjennomgått raskere og grundigere og\nintroduserer sjeldnere feil; boken legger til at gjennomgåere med rette kan\navvise en endring som for stor for én gjennomgang. Del opp arbeidet: stable små\nendringer oppå hverandre, send grupper av filer til ulike gjennomgåere, hold\nrefaktoreringer adskilt fra nye funksjoner og feilrettinger, og la hver\nendrings tester ligge i samme endring.\n\n**Gjennomgangen blir liggende i dagevis.** Hver dag en endring venter,\nforsinker arbeidet som bygger på den, og en gjennomgåer som bare svarer med\nnoen dagers mellomrom og med store krav, får prosessen til å føles strengere\nenn den er. Svar innen én arbeidsdag; bokens forventning er tilbakemelding innen\n24 arbeidstimer, og hvis den fulle gjennomgangen må vente, bør gjennomgåeren si\nat endringen er sett. Send alle kommentarene samlet i stedet for stykkevis, for\nfå ting irriterer en forfatter mer enn en ny runde urelaterte tilbakemeldinger\netter at den forrige er tatt hånd om.\n\n**Smak blir framstilt som krav.** En gjennomgåer som foretrekker en annen løkke\neller et annet navn og blokkerer endringen for det, lærer forfatterne å slutte å\nforbedre koden. Googles veiledning fastsetter rekkefølgen: tekniske fakta og\ndata veier tyngre enn meninger og personlige preferanser, stilguiden er den\nabsolutte autoriteten i spørsmål om stil, og der flere tilnærminger er like\ngode, vinner forfatterens preferanse. Merk en preferanse som Nit eller\nOptional, slik at forfatteren kan skille den fra et krav.\n\n**Kommentaren handler om personen.** Veiledningens eget eksempel på en dårlig\nkommentar spør hvorfor forfatteren brukte tråder når det åpenbart ikke er noen\ngevinst ved samtidighet; den gode versjonen sier at samtidighetsmodellen\ntilfører kompleksitet uten noen ytelsesgevinst gjennomgåeren kan se, så koden\nbør være enkelttrådet. Kommenter koden, aldri utvikleren, og forklar\nbegrunnelsen bak ønsket.\n\n**Mennesker sjekker det en maskin kunne.** Gjennomgåere som bruker\noppmerksomheten på mellomrom og importrekkefølge, overser designspørsmålet bare\net menneske kan svare på. Flytt hver regel som kan skrives ned, inn i en linter,\net formateringsverktøy eller en presubmit-kontroll, og la gjennomgåeren beholde\nskjønnsvurderingene.\n\n**Svaret blir værende i gjennomgangsverktøyet.** En gjennomgåer spør hva en\nkodeblokk er til, forfatteren forklarer i tråden, gjennomgåeren godkjenner, og\nden neste som leser koden, ser aldri forklaringen. Googles veiledning sier at et\nslikt spørsmål som regel bør føre til at koden skrives om så den blir\ntydeligere, eller i det minste til en kommentar i koden. Linux-kjernen sier det\nsamme til forfatterne: spørsmål i en gjennomgang som ikke fører til en\nkodeendring, bør nesten helt sikkert føre til en kommentar eller en oppføring i\nendringsloggen.\n\n## Les mer\n\n- [Introduction](https://google.github.io/eng-practices/review/)\n  — åpningssiden i Googles veiledning for kodegjennomgang: hva gjennomgåere ser\n  etter, hvordan man velger dem, og når parprogrammering teller som gjennomgang.\n- [The Standard of Code Review](https://google.github.io/eng-practices/review/reviewer/standard.html)\n  — det overordnede prinsippet, veiledning gjennom gjennomganger og hvordan\n  konflikter mellom forfatter og gjennomgåer løses.\n- [Small CLs](https://google.github.io/eng-practices/review/developer/small-cls.html)\n  — hvorfor små endringer får bedre gjennomganger, når en endring er for stor,\n  og fire måter å dele den opp på.\n- [Code Review](https://abseil.io/resources/swe-book/html/ch09.html)\n  — Tom Manshreck og Caitlin Sadowskis kapittel i _Software Engineering at\n  Google_: fordelene ved gjennomgang, LGTM og eierskap, og god praksis.\n- [Pull request reviews](https://docs.github.com/en/pull-requests/reference/pull-request-reviews)\n  — GitHubs referanse om å gjennomgå, godkjenne og be om endringer og om å kreve\n  godkjenninger før innfletting.\n- [Submitting patches: the essential guide to getting your code into the kernel](https://docs.kernel.org/process/submitting-patches.html)\n  — hvordan Linux-kjernen gjennomgår over e-post, hva en Reviewed-by-tag\n  erklærer, og hvordan forfattere bør svare gjennomgåerne.\n\n\u003chttps://engineer.company/nb/glossary/code-review/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva en kodegjennomgang sjekker, et gjennomgått eksempel på en liten prisendring med merkede kommentarer og vanene som gjør gjennomgangen treg eller personlig.","formats":{"gemtext":"https://engineer.company/nb/glossary/code-review/index.gmi","gopher":"https://engineer.company/nb/glossary/code-review/gophermap","html":"https://engineer.company/nb/glossary/code-review/","json":"https://engineer.company/nb/glossary/code-review/index.json","markdown":"https://engineer.company/nb/glossary/code-review/index.md","pdf":"https://engineer.company/nb/glossary/code-review/index.pdf"},"kind":"page","language":"nb","title":"Hva er kodegjennomgang?","url":"https://engineer.company/nb/glossary/code-review/","version":1}