.

21.4.2009 11:13 | GNU/Linux | | poslední úprava: 28.8.2015 10:15

deleted

       

Komentáře

[hikikomori82]

http://www.ohloh.net/p/moodleed/widgets

[Martin Stiborský]

Hezká udělátka, díky, nevěděl jsem o tom.

[freshmouse]

Nahlédl jsem do zdrojáků a, co se týče komentářů, vypadá to na pěknou taškařici... Namátkou:

- Nu tedy, tohle by melo fungovat tak, ze to koukne na predhozene otazky, urci to jejich typ, pak to vypreparuje zadani otazky, jednotlive otazky a tyto data preda v nejake slusne forme metodam jednotliych otazek ktere se postaraji o vyplneni odpovidajich GUI widgetu. Tot idea nyni v 15:05 dne 25/2 2009. Nemam sajn v jake forme jednotliva data vracet. Ach jo.

- uz se to tu zacina rysovat, wooohooo, je to prasarna nejspis, ale bude to fungovat na to ze jsem mel pulku vikendu hlavu v lihu, mam celkem jasno :)

- !!! TODO !!! tady to bude chctit hooooooodne komentaru

... tohle je tam místo nějakých popisů rozhraní. A pak je tam každý řádek kódu, byť sebejednoduššího, komentován jednořádkovým komentářem. Např.:

# zavru soubor
questionFile.close()

[Kvakor]

A pak je tam každý řádek kódu, byť sebejednoduššího, komentován jednořádkovým komentářem.

Jsou vyučující, kteří své žáky do tohoto stylu komentování nutí. Prý z toho důvodu, že je to snadno vyhodnotitelné - než se hádat, co už komentář potřebuje a co je zdřejmé samo o sobě*, tak ať jsou radějí komentáře všude. Pokud je to jazyk kompilovaný (jedno do čeho, hlavně když proleze parserem), je to celkem putna, ale u skriptů v produkčním prostředí je podobná taktika spíš kontraproduktivní, leda že se udržují vedle sebe "vývojová" verze (s komenáři) a proukční verze (bez nich), jako je to běžné u různých javascriptových toolkitů.

*Tohle je navíc velmi subjektivní, protože to, co je pro autora zjevné, nemusí být zjevné pro někoho, kdo kód vidí poprvé. Setkal jsem se s jinak zkušeným programátorem, který koukal na z mojeho pohledu celkem nevinnou konstrukci používající bitové operace jako vyoraná myš na nová vrata. Naopak já jsem se setkal s několika SQL příkazy či regexp výrazy, o kterých jsem musel opravdu dlouho přemýšlet, co tím chtěl básník, ehm, programátor říct, ale autorovi nestály ani za zmínku.

[Martin Stiborský]

Některé komentáře jsou fakt navíc a zbytečné, mimo to, přímo do kódu si občas píšu různé poznámky, občas trochu ujedu a připíšu ti tam nějaké koniny, ale to je celkem detail snad ..

[moira]

Toť "nevýhoda" open source :)

[Martin Stiborský]

Ano ano, taškařice převeliká. Commit logy jsi zkouknul ? Tam jsem se taky vyřádil když jsem byl v náladě, přímo třeskutá taškařice.

Vytáhl jsi ten největší problém, fakt že jo, díky ti.

[Michal]

Chci se zeptat, jestli by nebyl čas na dodělávky programu. Využívám jej pro export, ale potřeboval bych jej specificky upravit. Děkuji za odpověď.

[Martin Stiborský]

Netušil jsem, že to vůbec někdo používá ;)

Napiš mi prosím na mail a dohodneme se (martin.stiborsky at gmail.com)