<html><body>Dobrý den,<br><br>rádi bychom se s Vámi domluvili na termÃnu osobnÃho pÅedvedenà naÅ¡Ã semestrálnà práce z OSů. V týmu jsme se shodli, že v pÅÃÅ¡tÃm týdnu nemáme nÄjaké datum, kdy by se nám schůzka nehodila. Poprosil bych Vás proto, abyste navrhl termÃn, kdy by se schůzka hodila Vám.<div><br></div><div>DÄkujeme.<br><br>S pozdravem,<br>Jan Å kvaÅil<br><br><p>---------- Původnà zpráva ----------<br>Od: Martin Decky <decky@d3s.mff.cuni.cz><br>Datum: 14. 2. 2014<br>PÅedmÄt: [OSy] Odevzdavani rozsireneho zadani</p><br><blockquote>Vazeni kolegove,<br><br>protoze se pro vetsinu skupin pomalu blizi termin dokonceni rozsireneho <br>zadani semestralky z OSu, rad bych Vas poprosil, abyste mi napsali, <br>jakmile budete mit hovoto, abychom se domluvime na konkretnim case <br>osobniho odevzdani Vaseho reseni.<br><br>Behem osobniho odevzdani projdeme stav Vaseho repository (k terminu <br>dokonceni) a dozvite se hruby odhad bodoveho hodnoceni. Finalni podrobne <br>ohodnoceni obdrzite v nasledujicich tydnech po odevzdani, jakmile Vasi <br>praci dukladne prostudujeme.<br><br>Zaverem strucne nekolik rad k zaverecnemu odevzdavani:<br><br>1) Soucasti repository musi byt k casu odevzdani vse, co si prejete <br>zahrnout do Vaseho finalniho reseni. Na cokoliv, co nam napriklad <br>poslete emailem nebo commitnete do repository po deadline, nebudeme brat <br>zretel (az na mimoradne a explicitne schvalene vyjimky).<br><br>2) Jako obvykle pri odevzdavani dila tohoto rozsahu je dobre vyvarovat <br>se zasadnich zmen a prepisovani tesne pred odevzdanim. I v pripade, ze <br>Vam neco trochu nefunguje, radeji se to nepokousejte zurive na posledni <br>chvili opravit, protoze muzete nechte rozbit neco jineho. Hodnoceni <br>finalniho reseni rozhodne nebude binarni.<br><br>3) Nekolik poslednich dnu pred deadline je vhodne venovat uprave a <br>unifikaci zdrojovych kodu (aby cela semestralka mela jednotny coding <br>style), dopisovani dokumentace atd.<br><br>4) Pokud pouzivate nejaky nastroj pro referencni dokumentaci (napr. <br>Doxygen), prosim necommitujte do repository vystup tohoto nastroje. <br>Typicky se totiz jedna o stovky malinkych HTML a PNG souboru, ktere <br>jednak nema valny smysl verzovat a jednak to repository zbytecne <br>zvetsuje. Bohate postaci, kdyz bude mozne referencni dokumentaci snadno <br>ze zdrojoveho stromu vygenerovat.<br><br>5) Naopak, pokud budete mit nejakou rucne psanou dokumentaci vytvorenou <br>nejakym nezavislym prostredkem (napr. v beznem textovem editoru), potom <br>je samozrejme na miste, abyste do repository commitnuli treba export ve <br>formatu PDF pro pohodlne cteni.<br><br>6) Pripominam, ze je velmi uzitecne, aby rucne psana a generovana <br>dokumentace spolu byly vhodne hypertextove provazany (aby ctenar mohl <br>snadno prechazet od "high-level" popisu k "low-level" dokumentaci a <br>pripadne i zpet). Proto byva velmi caste, ze i rucne psana cast <br>dokumentace je soucasti vstupu pro generovani referencni dokumentace a <br>tvori s ni jeden celek.<br><br>7) Dokumenaci samozrejme neni potreba tisknout, chranme nase stromy :)<br><br>8) Doporucuji projit si znovu slajdy z uvodniho cviceni, abyste si <br>pripomneli, podle jakych kriterii budeme Vase semestralky hodnotit. <br>Verim, ze nektere veci ze slajdu Vam teprve ted budou davat smysl.<br><br>http://d3s.mff.cuni.cz/teaching/operating_systems/download/20131003-nswi004-agenda.pdf<br><br>Velmi strucne shrnuji:<br><br>* Pruchod testy jiz neni nutna podminka, ale pouze jedno z kriterii pro<br> hodnoceni rozsireneho zadani (zapocitava se do kvality implementace).<br> Presto je vhodne, aby Vase finalni reseni proslo idealne vsemi testy<br> vsech zakladnich zadani a pripadne i testy rozsireneho zadani,<br> jsou-li k dispozici.<br><br>* Kvalita zdrojovych kodu ma stejnou vahu jako funkcnost a kvalita<br> dokumentace. Snazte se tedy o to, aby odevzdavane zdrojaky byly<br> prehledne, upravene, vhodne komentovane, konzistentni, bez<br> zakomentovanych "marnych pokusu", pomocnych ladicich funkci atd.<br><br>* Snazte se take dodrzet pozadavky na pouziti vhodnych programatorskych<br> prostredku, tedy vhodnou volbu algoritmu a datovych struktur<br> (predevsim z hlediska efektivity pro nejtypictejsi pripad pouziti v<br> danem kontextu), vhodne oddeleni ruznych urovni abstrakce v kodu atd.<br><br>* Rucne psana dokumentace je v zasade nezbytna. Mela by popisovat<br> obecne vlastnosti Vaseho reseni, celkovou architekturu, pouzite<br> algoritmy z "high-level" pohledu, mela by informovat ctenare o tom,<br> kde ve zdrojovych souborech nalezne jejich konkretni implementace<br> atd. Soucasti hodnoceni dokumentace je samozrejme i Vase drivejsi<br> ustni prezentace na cviceni.<br><br>* Doplnujici je referencni dokumentace. Aby byla referencni<br> dokumentace vubec k necemu uzitecna, musi byt v kodu dusledne<br> pouzivany dokumentacni komentare a to u vsech dulezitych entit<br> (souboru, datovych typu, globalnich promennych, funkci, maker atd.).<br> Neni mnoho horsich veci nez "derava" referencni dokumentace, ktera<br> obsahuje popis jen poloviny veci ze zdrojaku.<br><br>* Pokud je soucasti Vaseho rozsireneho zadani take povinnost vypracovat<br> nejake porovnani je potreba vysledky (tabulky, grafy) zahrnout do<br> dokumentace a je take potreba pripojit Vas slovni komentar nebo<br> vyhodnoceni (tedy nestaci jen surova data bez dalsiho zpracovani).<br><br>9) Pokud jste v ramci Vaseho reseni implementovali neco nad ramec zadani <br>nebo pouzili nejaky mimoradne zajimavy postup, urcite je vhodne napsat <br>to do dokumentace -- i pri podrobnem prochazeni zdrojaku muze totiz <br>hezka myslenka zapadnout.<br><br>10) Plati ovsem totez i obracene: Pokud vite, ze jste neco ze zadani <br>nestihli nebo neco nechodi tak, jak by melo, uvedte to prosim v <br>dokumentaci. Pomuze nam to lepe ohodnotit rozsah takoveho "problemu" a <br>lepe poznat, zda to, co vidime ve zdrojaku, je jen nedokonceny pokus o <br>implementaci a ne neco, o cem si chybne myslite, ze by vlastne melo <br>fungovat.<br><br><br>V pripade libovolnych nejasnosti, dotazu nebo pripominek prosim <br>nevahejte napsat do teto konference. Preji vsem hodne zdaru pri odevzdavani!<br><br><br>M.D.<br><br>_______________________________________________<br>OSy mailing list<br>OSy@d3s.mff.cuni.cz<br>https://d3s.mff.cuni.cz/mailman/listinfo/osy</blockquote></div></body></html>