I denna kursen kommer en av de centrala delarna bestå i så kallad peer-review, på svenska även kallat referensgranskning. Det innebär i korta drag att ni kommer få studera varandras lösningar på de olika problemdelarna i kursen. Tanken med steget är dels att ni ska få visa er kunskap genom att analysera och ge kommenterar på andras kod samt förhoppningsvis också få bra feedback på er egen kod. Tanken med denna del är inte att ni på något sätt ska sätta betyg på varandra utan mer kunna pusha och ge varandra god feedback samt visa att ni förstår applikationen genom era kommentarer. Dessutom är det viktigt att kunna stiga ur sin egen bubbla och reflektera över andras arbete.
GitHub
Då vi kursen använder GitHub för kodhantering kommer vi också använda deras verktyg för att diskutera kod. De flesta av er använder förmodligen öppna repositorier och att studera andra kod blir då lätt. Man kan välja att forka ut applikationerna eller att klona ut dem för att studera koden.
Under tiden du studerar koden lämnar du feedback på koden via GitHubs funktion “issues”. Läs igenom denna guide och få en insikt om hur den funkar och hur man kan kommunicera via github. Vill du kan du såklart forka projektet och göra egna ändringar på koden och föreslå dessa genom en “Pull request”.
Vad gör examinatorn?
Jag kommer såklart övervaka era repon och framförallt koncentrera mig på hur ni lämnar kommentarer och feedback vilket skvallrar om er kunskap i området. Se därför till att lägga tid på dessa. Fortlöpande under kursen antas och kontrolleras också att ni rättar till eventuella buggar i er applikation och stänger de issues som ni fått.
Arbetsgång
1. När du känner dig klar med din uppgift gör du en release/tag på din kod (senast 5:e feb klockan 08:00). Se också till att skriva tydliga instruktioner i din README hur man ska kunna köra din applikation. Försök undvika allt extrajobb för din peer. Se till att du fyller din seed-fil o.s.v.
2. Anmäl dig att du är färdig för att delta i peer-review (obligatoriskt i kursen). Din applikation ska vara färdig, lämna inte in något som inte funkar! (senast 5:e feb klockan 08:00). Du hittar anmälningsformuläret nedan. Missar du detta kommer du inte få något repo att granska.
3. Under fredagen kommer du få ett mejl med instruktioner och information om det repo du ska göra din peer-review på (blir bara ett denna gång). Du studerar koden. Testkör noga applikationen och ger din feedback via GitHub. Du ska också fylla i ett mindre formulär kring din granskning. Länk kommer också finnas i mejlet.
4. Din peer-review ska vara gjord senast onsdagen veckan efter. Se till att gå igenom de kommentarer du själv fått och kom ihåg att github kan användas för att före en diskussion kring koden. Känns diskussionen färdig eller att du fixat en bugg så gör en “close” på den “issue” du arbetat med.
5. Glöm inte bort att samtidigt börja jobba med API-tjänsten annars kommer det blir tajt med tid till den senare.
6. Frågor? Ställ dem i kursens slack-kanal…
