HARJOITUSTYÖHÖN LIITTYVÄN MODUULIN VERTAISPALAUTEEN OHJE
C-OHJELMOINTI KURSSILLA (Syksy 2010)
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.
Palautteen antajat laittavat palautteen
keskustelualueelle vastauksena arvioimaansa koodiin. Näin esimerkiksi
vertaispalautteen antajat voivat tarkastella
olivatko samaa mieltä arvioimastaan koodista.
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 pe 15.10.2010.
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?
- Puskurin ylivuodot
Onko koodissa puskurin ylivuotoja? (Tarkista funktion scanf käyttö. Onko
koodissa kutsuttu funktiota gets? Onko ohjelmoija varannut muistia
myös merkkijono lopetusmerkille (null character).)
- 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.