Komentarji nalog

Profesor je najprej domèe naloge skopiral z ,,novièk`` na internetu, jih pregledal in popravil. Ko je le te popravil, je na vsako nalogo posebej napisal in oznaèil kje in kaj smo naredili narobe. Naloge je ocenjeval po ¹tirih kriterijih, ki se nato ¹e razvejajo na podtoèke.

• Pravilnost:                                             30

  1.

  pravilno obravnavanje podatkov           12

  2.

  pravilnost postopka (algoritem)            12

  3.

  uèinkovitost                                     6

• Arhitektura programa:                              30

  1.

  pravilna uporaba jezikovnih elementov      7
  (for, while, if, ...)

  2.

  globalne spremenljivke in konstante          3
  (jih naèeloma ni)

  3.

  ali so funkcije uporabljene                     4

  4.

  smiselnost funkcij                              3

  5.

  smiselnost parametrov funkcij               3

  6.

  pogodbe in njihova pravilnost               10

• Dokumentacija:                               30

  1.

  imena spremenljivk in funkcij             3

  2.

  komentarji v kodi                         4

  3.

  vsaka spremenljivka (in funkcija)         3

  4.

  smiselnost vsebine komentarjev            5

  5.

  smiselnost vsebine pogodb                 6

  6.

  dokumentacija o tem, kako se program prevede                               6

  7.

  dokumentacija o uporabi programa          6

• Preverjanje, izvajanje                       10

  1.

  program se prevede (je sintaktièno pravilen)                    3

  2.

  program pravilno dela                   7

• SKUPAJ                                       100

Najveè mo¾nih toèk je bilo 100. Te so bile porazdeljene tako kot prikazuje shema.

Najveè napak smo imeli pri dokumentaciji, kjer nismo pravilno opisovali, komentirali delovanje programa. Zaradi tega profesor ni pregledal èetrte toèke. Dokumentacija mora biti napisana tako, da jo razume vsak, ki bo hotel delati z na¹im programom. Vsebovati mora opis, kaj, kako program deluje, kak¹ni morajo biti vhodni podatki, da zadovolimo delovanje programa, kaj dobimo na izhodu in predvsem komentar kako se ga uporablja.

Imena, ki jih uporabljamo naj bodo smiselna. Naj bodo napisana z besedo in ne z èrko, kot naprimer ime ,,dol¾ina`` naj bo raje napisano z besedo dol¾ina, kjer nam ime pove kaj funkcija opravlja in ne z èrko d, kjer ne vemo kaj je definirano pod to èrko.

Funkcijo, ki jo definiramo, naj bo doloèena za eno nalogo in ne za dve ali veè.

Knji¾nice, ki jih uporabljamo naj bi bile standardne.