Retting av obligatoriske oppgaver
Etter hver innlevering blir alle tildelt en rettegruppe, med tre studenter i hver gruppe. Hver gruppe gis tilgang til tre innleverte git-repositorier. Disse klones til egen maskin på vanlig måte (se instrukser fra forelesning). Deretter skal innleveringen vurderes, etter følgende kriterier:
- Er programmene lette å lese og forstå?
- Fornuftige og beskrivende variabelnavn
- Ryddig formatering av koden
- Gjennomført og konsistent kodestil
- Nok kommentarer, f.eks. innledende beskrivelse av script, beskrivelse av hver funksjon/klasse, beskrivelse av evt globale funksjoner, samt beskrivelse av eventuelle kodesnutter som ikke er selvforklarende
- Løser programmene de problemene de skal?
- Er det lett å forstå hvordan programmet kjøres?
- Gode feilmeldinger og "usage"-beskrivelse hvis programmet brukes feil
- Gjerne -h eller liknende opsjon for å forklare bruk av programmet
- Er implementasjonen verifisert/testet?
- Testene må være lette å kjøre, og det må finnes en beskrivelse av hvordan de kjøres
- Bør dekke alle de sentrale funksjonene og klassene i koden, samt så mange feilsituasjoner og brukseksempler som mulig (f.eks. ulike if-tester)
- Er rapporten velskrevet, og beskriver den de viktigste delene av oppgaveløsningen?
- Rapporten bør vise at testene er kjørt, slik at programmene er verifisert
- Rapporten bør beskrive hvordan hver enkelt deloppgave er løst, gjerne med utskrift av sentral kode
- Ryddig formattert og minimalt med skrivefeil
Basert på disse fem kriteriene skrives en kort rapport (minimum 20-30 linjer) som beskriver og vurderer besvarelsen. Rapporten skrives i en ren tekstfil som pushes til git-repositoriet for besvarelsen (husk git add, se ellers instrukser i forelesningsfoiler). Navnet på fila med rapporten skal være som følger:
- Hvis det kan svares "JA" på minst fire av de fem spørsmålene over skal innleveringen godkjennes, og fila gis navnet REVIEW1_YES
- Hvis det ikke kan svares "JA" på fire av fem spørsmal skal innleveringen underkjennes, og fila gis navnet REVIEW1_NO
"JA" på fire av fem spørsmål er en veiledende grense, som prøver å angi hvor nivået for en godkjent oblig skal ligge. Det må likevel gjøres en helhetsvurdering av innleveringen. Ved to klare "NEI" på spørsmålene bør obligen uansett ikke godkjennes, men med fire svake "JA" kan også oppgaven underkjennes hvis helheten tilsier det.
Husk at rapport-filen skal inneholde en vurdering av innleveringen, uansett om den godkjennes eller ikke. For innleveringer som ikke godkjennes er det spesielt viktig å spesifisere hva som må forbedres. Tidsfristen for retting er en uke etter at gruppen gis tilgang til repositoriene.
Obligatoriske oppgaver som ikke godkjennes gis en ny tidsfrist for innlevering, normalt ca en uke etter mottatt tilbakemelding. I denne runden er det gruppelærerne som står for retting og godkjenning av oppgavene.