Tietokannat ja web-ohjelmointi

Vertaisarviointi

Vertaisarvioinnissa tutustut toisen kurssin opiskelijan työhön ja annat siitä palautetta. Vastavuoroisesti saat omasta työstäsi palautetta toiselta opiskelijalta.

Vertaisarvioinnin ohje

  1. Löydät linkin arvioitavan työn GitHub-sivulle Labtoolista.
  2. Tutustu ensin sovellukseen kloonaamalla repositorio omalle koneellesi ja testaamalla sovelluksen toimintaa. Kiinnitä huomiota siihen, miten sovellus toimii ja onko sitä mukava käyttää.
  3. Tämän jälkeen käy läpi sovelluksen koodi ja tietokannan rakenne. Mieti, mitä asioita sovelluksen toteutuksessa voisi parantaa.
  4. Lisää arvioitavan työn GitHub-sivulle issue, jossa raportoit kohdissa 2 ja 3 huomaamasi asiat. Koeta kirjoittaa raportti niin, että se auttaa työn tekijää.
  5. Lisää URL-osoite (linkki) kirjoittamaasi issueen Labtooliin. Varmista linkkiä lisätessäsi, että linkin alussa on protokollan määrittely https.

Huomaa, että “Hyvältä näyttää” tms. ei ole riittävä raportti. Jos työ on jo hyvässä vaiheessa, voit huomauttaa myös pienemmistä asioista. Älä kuitenkaan kirjoita mitään raporttiin vain sen takia, että siihen tulisi enemmän pituutta.

Jos saat arvioitavaksi sovelluksen, joka on hyvin alkuvaiheessa (esimerkiksi repositoriossa on pelkkä tiedosto README.md), voit kirjoittaa hyvin lyhyen vertaisarvioinnin ja todeta, ettei arvioitavaa ole.

Esimerkkiarvioinnit

Vertaisarvioinnin kattavuus on kurssin arvosteluun vaikuttava asia. Seuraavat esimerkkisovelluksen vertaisarvioinnit selventävät, mitä tämä tarkoittaa:

Ensimmäinen vertaisarviointi on suppea: se täyttää vaatimuksen vertaisarvioinnista mutta ei ole kovin hyödyllinen sovelluksen tekijälle, koska palaute on annettu lyhyesti ja epämääräisesti.

Toinen vertaisarviointi on kattava: siinä on yksityiskohtaista palautetta sovelluksen käyttökokemuksesta sekä ehdotuksia teknisen toteutuksen parantamiseen. Tällaisen raportin avulla sovelluksen tekijä saa konkreettista tietoa siitä, miten hän pystyy parantamaan sovellusta.

Kun saat vertaisarvioinnin

Kun saat vertaisarvioinnin omasta työstäsi, koeta hyödyntää sitä sovelluksesi kehityksessä. Usein ulkopuolinen huomaa asioita, joihin ei ole kiinnittänyt itse huomiota. Kuitenkin voit saada myös neuvoja, joita ei kannata noudattaa. Vastuu sovelluksen kehityksestä on aina itselläsi.