Skip to content

GitHub

I Storsalen Utvikling bruker vi GitHub som plattform for versjonskontroll og samarbeid om kildekode. GitHub må ikke forveksles med git, hvor git er en teknologi for versjonskontroll og GitHub er en plattform som "hoster" kildekode ved hjelp av git-teknologien. Nedenfor følger info om hvordan vi bruker de forskjellige tingene GitHub har å by på, til slutt vil det være en liten guide for å sette opp git på maskinen din og noen gode tips og triks.

Projects

GitHub har såkalte projects som lar oss organisere arbeid på en god og oversiktlig måte. Du finner pågående prosjekter her (du må være logget inn), og det vil se omtrent sånn her ut:

Oversikt over GitHub-prosjekter

Her kommer vi til å opprette prosjekter for hver ting vi jobber med i Storsalen Utvikling (som for øyeblikket bare er Wiki og Appen). Hvis vi går videre inn på et prosjekt, for eksempel dev.storsalen.no (wiki), så får vi opp et board med oversikt over planlagte, påbegynte og ferdige oppgaver:

Wiki-prosjektet i GitHub

Her er det bare å følge med, og ta tak i de oppgavene som du tror du kan få til. Ved å trykke videre inn på oppgavene kan man sette seg selv opp som Assignee og etter hvert koble oppgaven til en Pull Request når koden er ferdig utviklet og skal gjennomgå kontroll av andre i teamet. Det er også mulig å kommentere på en oppgave hvis man har innspill til hvordan den best kan løses.

Håndbok for utvikling

Mer info om arbeidsprosessen for hvert prosjekt finner du under på prosjektsidene her på wikien.

Repositories

GitHub repositories brukes for å lagre og samarbeide om kildekode. Du finner alle våre repositories her (du må være logget inn). Hvis du klikker videre inn på et prosjekt (f.eks. storsalen-utvikling-wiki) vil du komme til kildekoden, det ser omtrent sånn her ut:

Wiki-repository i GitHub

Langs den øverste fanen her er det en del nyttige snarveier:

  1. Issues som lister opp alle oppgaver som er tilknyttet denne koden.
  2. Pull requests hvor vi gjennomgår hverandres kode før det inkluderes i main
  3. Projects som viser hvilke prosjekter koden er tilknyttet

Lenger ned på siden kan man velge hvilken branch av koden man ønsker å se på (her ser vi på main). Lenger til høyre kan man trykke på Code for å klone ned koden og begynne å jobbe.

Git er industristandarden for versjonskontroll av kode, så selv om det kan være krevende å lære seg å bruke det effektivt så er det verdt å bruke tiden på det. Det er også veldig mange som bruker GitHub som plattform for git, så her kan du lære mye om hvordan utvikling foregår ute i den virkelige verden.

Oppsett

Det første du må gjøre er å installere git på din maskin, det finner du her. Du finner en hel bok om git her som forklarer ting godt, men for oppsett kan du hoppe frem til kapittelet om First-Time Git Setup og følge stegene. For å slippe å skrive brukernavn og passord hver gang du skal kjøre git pull og git push kan det være nyttig å benytte SSH. Oppsett av SSH kan gjøres her, der er det også linket til en guide som kan følges hvis du ikke er kjent med dette fra før.