Navodila za splošno poročilo
V kolikor vaje zahtevajo splošno poročilo, je potrebno oddati poročilo, skladno s sledečimi navodili.
Za uspešno opravljene vaje, morate oddati zahtevana poročila, ki jih nato asistent potrdi. Če oddano poročilo ne bo ustrezno, boste o tem obveščeni, da lahko poročilo popravite.
Format poročila
Za poročila so močno zaželene Markdown datoteke (končnica .md). Na spletni učilnici imate povezavo na pregledno tabelo ukazov za delo z Markdown datotekami in pa primer poročila, ki ga lahko uporabljate kot stilsko predlogo. Za predogled v VSCode uporabite ukaz Markdown: Open Preview.Datoteka naj bo poimenovana ImePriimek_ImeVaj.md
Vsebina
Vsako poročilo mora vsebovati:
- ime, priimek, datum in naslov vaj;
- kratek povzetek vaj, ki pove kratko vsebino vaj (povejte tudi, če vam je kateri od konceptov povzročal težave), posebnosti v načinu izvedbe (delo v paru, organizacija ekipnega dela, ...) in komentarje (težavnost, zanimiva opažanja);
- Napišite vašo izbiro nalog. Za vsako nalogo napišite sledeče:
- Besedilo naloge.
- Koda rešitve (obvezno v primernem formatu, glej Fenced code block na povezavi)
- Komentarji, opis ideje rešitve pri zahtevnejših nalogah, opis težav če naloge niste rešili do konca...
- Nekaj vaših testov (predvsem za težje naloge) in pričakovani rezultat. Označite kateri testi so za robne primere (če jih problem ima). V primeru, da vaša rešitev ne deluje pravilno, napišite dobljeni rezultat in pravilen rezultat.
- Če so vaje vsebovale kviz, napišite kako uspešni ste bili pri prvem reševanju (%) in koliko poskusov ste rabili za 100% (oz. kako uspešni ste bili na koncu). Komentirajte kviz.
- Če ste uporabljali vire in literaturo, to primerno navedite.
Ocena
Na poročila z vaj bo sproti podan odziv, ki pove, če je poročilo
sprejeto (pravočasno oddano v skladu z navodili). Sprejeta morate imeti vsa
poročila, z izjemo največ dveh. Ti odzivi niso povezani s končno oceno poročil, so pa pogoj, da jo lahko pridobite.
Poročila (in vaše sodelovanje na vajah) bodo ocenjena skupaj ob koncu semestra. Ta ocena bo
predstavljala 20% ocene iz vaj (glej Obveznosti).