Vertaisarvionti

Vertaisarvionti on osa Tiran harjoitustyötä, tästä voi saada maksimissaan 2 pistettä per kerta.

Katselmoinnin perimmäinen tarkoitus on oppia hahmottamaan toisen henkilön kirjoittamaa koodia ja kokonaista ohjelmointiprojektia. Toisten koodia luetaan kursseilla toistaiseksi valitettavan vähän, vaikka sujuva koodinlukutaito on välttämätön taito ohjelmoijan työssä. Hyvin suoritettu katselmointi on tehokas tapa havaita ongelmakohtia ja korjata virheitä mahdollisimman varhaisessa vaiheessa ohjelmointiprojektia.

Näet sinulle osoitetun katselmointikohteen repositoriolinkin labtoolista koodikatselmoinnin käynnistyttyä. Sinun tehtävänäsi on lukea läpi toisen opiskelijan harjoitustyö ja antaa siitä rakentavaa palautetta. Ohjelmaa kannattaa kokeilla myös suorittaa. Jos projekti on kuitenkin täysin tyhjä runko, tai parisi ei ole avannut issuetaan, niin ota yhteyttä ohjaajiin, valitsemme sinulle toisen katselmointikohteen.

Palaute annetaan Githubin Issuena

• Mene selaimellasi toisen opiskelijan repositorioon
• Valitse välilehti Issues
• Valitse oikeasta reunasta New Issue
• Anna otsikko "Koodikatselmointi"
• Kirjoita palautteesi kommenttilaatikkoon, Preview -välilehdestä näet palautteesi ulkomuodon
• Kommenttilaatikon yläpuolella on linkki tekstin muotoiluohjeisiin
• Palautelaatikko tukee myös kuvia
• Varmuuden vuoksi kopioi kirjoittamasi palaute koneellesi tekstitiedostoon
• Lisää palautteen alkuun päivä ja kellonaika, jolloin latasit annetun projektin
• Lähetä palaute valitsemalla Submit new issue
• Issue eli tässä tapauksessa palaute on koko repositorion tapaan julkinen, joten sen voi lukea kuka tahansa.
• Ohjaajat lukevat ja pisteyttävät annetun palautteen mahdollisimman pian deadlinen jälkeen.
• Tarkista, että oma projektisi on avoinna palautteen antamista varten.

Ohjeita arviointiin

• Lataa zip-pakattu projekti koneellesi annetun repositorion ZIP -painikkeesta
• Ota talteen kellonaika ja päivä, jolloin latasit projektin
• Pura projekti
• Lue ensimmäiseksi projektin aihemäärittely
• Tutustu mahdollisimman kattavasti ohjelmakoodiin sekä testeihin
• Kokeile myös avata projekti Netbeansissa ja aja testit
• Yritä ymmärtää, mitä mikäkin luokka ja metodi tekee
• Ole sinnikäs: Kaikkea ei aina osaa, eikä tarvitsekaan ymmärtää!
• Kun olet tutustunut riittävän tarkasti toisen projektiin, on aika antaa toiselle henkilölle palaute. Palautteessa ei tarvitse ottaa kantaa ohjelman dokumentointiin tai ulkonäköön.

Tulostettava sivu