Vertaisarviointi

Vertaisarviointi on osa harjoitustyötä ja se suoritetaan koodikatselmointina. Katselmointeja on kurssilla kaksi ja niiden arvo kurssin arvostelussa on yhteensä 4 pistettä.

Vertaisarvioinnissa harjoitellaan toisen henkilön toteuttaman sovelluksen toiminnallisuuden tarkastelua sekä sovellukseen liittyvän lähdekoodin toiminnallisuuden ymmärtämistä. Vertaisarvioinnin palaute tarjoaa mahdollisuuden sovelluksen ongelmakohtien tunnistamiseen sekä sovelluksessa olevien virheiden korjaamiseen. Toisten töitä tarkastelemalla voi nähdä myös omasta työskentelystä uusia puolia.

Ohjeet

Näet sinulle osoitetut katselmointikohteet labtoolista koodikatselmoinnin käynnistyttyä. Tehtävänäsi on lukea läpi toisen opiskelijan harjoitustyö ja antaa siitä rakentavaa palautetta. Ohjelmaa kannattaa kokeilla myös Githubissa olevien linkkien linkeistä. Jos sinulle määrätty projekti on tyhjä tai siinä ei ole juurikaan toiminnallisuutta, niin ota yhteyttä ohjaajiin. Saat tällöin toisen katselmointikohteen.

Katselmoinnin aloitus:

• 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
• Avaa projektin esittelysivu ja testaa projektia ensin selaimessa. Testaa projektia simuloimalla projektin käyttötapaukset -- saatko kaikki käyttötapaukset tehtyä ja onko niiden tekeminen helppoa ja luontevaa?
• Tarkastele sovellusta myös saavutettavuuden kannalta. Onko sovelluksessa käytetty oikeita HTML-elementtejä, ovatko sivut loogisessa järjestyksessä, onko mahdollisissa kuvissa tms ohjetekstejä, ja ovatko ne kuvaavia. Työtä kannattaa tarkastella myös valmiita työvälineitä (esim. AChecker) käyttäen.
• Tutustu mahdollisimman kattavasti ohjelmakoodiin
• Yritä ymmärtää, mitä mikäkin luokka ja metodi tekee -- ovathan luokat, metodit ja muuttujat nimetty kuvaavasti? Onko nimentä johdonmukaista, eli onko eri tiedostoissa samanlaisia asioita tekevät asiat nimetty samankaltaisella tavalla?
• Ole sinnikäs: Kaikkea ei aina osaa, eikä tarvitsekaan ymmärtää!
• Haastavin osuus lienee eri luokkien ja sivujen keskinäisten suhteiden hahmottaminen. Käytä hyväksesi toisen piirtämiä kaavioita. Vastaahan kaaviot ja muu sovelluksen dokumentaatio sovelluksen todellista toiminnallisuutta?
• Kun olet tutustunut riittävän tarkasti toisen projektiin, on aika antaa toiselle henkilölle palaute.
• Kun olet antanut palautteen, käy lisäämässä Labtoolissa linki antamaasi palautteeseen.

Palautteenanto

Sovelluksen testaaminen on olennainen osa vertaisarviointia, mutta palautetta ei tule kirjoittaa pelkästään testailun perusteella. Muista että vertaisarvion pitäisi ensisijaisesti perustua katselmoitavan sovelluksen koodiin.

Palautteessasi kerro toiselle opiskelijalle, missä on parannettavaa ja mitä teit ominaisuuksia tarkastellessasi. Mitä tarkempi palaute, sen arvokkaampaa se on palautteen saajalle. Voit antaa myös vinkkejä siitä, miten asioita voisi tehdä toisin tai onko ohjelman tai tietokannan rakenteessa parannettavaa. Jos havaitsit selkeitä bugeja tai virheellistä koodia, kerro siitä. Kannattaa kertoa myös, mikäli jotkin ohjelman osat eivät toimineet. Tarkoitus ei ole tehdä labtoolin-tyylisiä hieman pintapuolisia mainintoja, vaan tutkia koodia tarkasti ja antaa täsmällisiä parannusehdotuksia. Muista myös positiivinen palaute!

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.

Kustakin katselmoinnista jaetaan 0-2 pistettä. 5-10 laadukasta rakentavaa palautekommenttia riittää 2 pisteeseen. Palaute kirjoitetaan vapaamuotoisena, mutta yritä kirjoittaa selkeästi. Jaa palaute eri luokista eri kappaleisiin. Jos kirjoitat ranskalaisia viivoja, kirjoita kokonaisia lauseita tai mieluiten useita lauseita. Älä hyökkää palautteessa toista kohtaan! Toisaalta älä ota annettua palautetta itseesi - projektisihan on yhä kesken ja muokattavissa. Palautteen antajakin toisinaan ymmärtää väärin tai antaa virheellisiä ohjeita.

Huom. Katselmoinnin kohteen projekti saattaa elää tai päivittyä sillä aikaa, kun kirjoitat palautetta. Tämän vuoksi palautteeseen liitetään aika, jolloin projektin kävi lataamassa itsellensä. Muulla tavalla asiaan ei kiinnitetä tällä kurssilla huomiota, eikä katselmoijan tarvitse aktiivisesti yrittää tarkistaa, jos jokin asia onkin ehtinyt jo muuttumaan. Palaute voi siis olla osin jo vanhentunutta.