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.