HARJOITUSTYöHÖN LIITTYVÄN MODUULIN VERTAISPALAUTEEN OHJE
C-OHJELMOINTI KURSSILLA (Syksy 2009)
YLEISTÄ
Ryhmä/yksilötyöntekijä
antaa vertaispalautetta kahdesta työstä.
Intranetissä olevassa
tiedostossa
kerrotaan kenen töistä palaute annetaan.
Projektityön ryhmässä
tekevät voivat antaa palautetta ryhmänä. Tämä edellyttää kuitenkin, että
kaikki ryhmän jäsenet osallistuvat palautteen antamiseen. Mikäli ryhmällä
ei ole mahdollisuutta antaa palautetta ryhmänä, niin silloin jokainen ryhmän
jäsen antaa palautteen itsenäisesti.
Jokainen ryhmä/yksilötyöntekijä ilmoittaa keskustelualueella palautettuun
työhön liittyvässä keskustelussa saako vertaispalautteen laittaa keskustelualueelle.
(Pahoittelen, etten huomannut pyytää lupaa jo palautuksen yhteydessä.)
Jos tämä lupa on annettu, niin silloin palautteen antajat laittavat palautteen
keskustelualueelle vastauksena arvioimaansa koodiin. Näin esimerkiksi
vertaispalautteen antajat voivat tarkastella
olivatko samaa mieltä arvioimastaan koodista. Jos lupaa ei ole annettu
vertaispalautteen laittamiselle keskustelualueelle tai palautteen antaja ei
halua palautettaan nähtäville, niin silloin palaute lähetetään
suoraan koodin kirjoittajille ja opettajille sähköpostitse.
Muista antaa rakentavaa ja innostavaa palautetta. Muista myös, että
keskustelualueelle annettu palaute näkyy kaikille kurssialueella.
Vertaispalautteesta saa pisteen / palaute. Ja maksimi on siis 2 pistettä.
Palutteen alussa kerrotaan kenen/keiden töistä vertaispalaute on ja
työn nimi.
Palautteen lopussa kerrotaan kuka/ketkä on tehnyt vertaispalautteen.
Vertaispalaute annetaan viimeistään ke 21.10.2009.
PALAUTE
Palautetta annetaan seuraavista asioista:
- Ohjelmointityyli
Onko ohjelmointityyli yhtenäinen ja noudattaako se Müldnerin kirjan
C for Java programmers ohjeistusta?
Onko muuttujilla kuvaavat nimet, joista selviää käyttötarkoitus?
Selviääkö muuttujien nimestä tyyppi? (Erityisesti osoitinmuuttujat
ja rakenteet.)
- Kommentointi
Onko kommentointi tehty Müldnerin kirjan tai
harjoitustyön ohjeiden mukaisesti?
- Moduulin rajapinta
Onko moduulin rajapinta määritelty hyvin? Onko jako funktioihin
järkevä?
-
- Virhetilanteet
Onko koodissa varauduttu virhetilanteisiin?
Onko koodaus suoritettu siten, että myös koodauksessa
tulleet virheet huomataan mahdollisimman aikaisessa vaiheessa?
- Kirjastot
Vain standardikirjastoja saa käyttää harjoitustyössä. Onko ohjetta
noudatettu?
- Käännös
Käännä ohjelma harjoitustyön ohjeessa annetuilla optioilla.
Jos tuli virheitä tai varoituksia, niin listaa ne.
- Suoritus
Mikäli testausohjelmakin oli tehty, niin käännä testausohjelma.
Linkitä objektitiedostot suoritettavaksi ohjelmaksi.
Aja testausohjelmaa. Saitko ohjelman avulla testattua moduulia?
Kerro miltä osin moduuli näytti toimivan oikein? Kerro myös, jos löysit
virheellistä toimintaa.
- Parannusehdotukset
Anna parannusehdotuksia. Erityisesti, jos moduulin rajapinnan
määrittelyssä oli korjattavaa.
- Kehut
Muista myös kertoa, mikä oli hyvin tehty.