Egyébként a magam részéről kifejezetten kiakasztónak találom a PHPDoc/JavaDoc/nemtudommianevedocaC#-ban/stb. függvény elejére írt novellákat. Egyrészt, mert egy normális dokumentációt nem helyettesít, csak API docnak jó, másrészt, ha tényleg normálisan meg van írva, akkor iszonyúan meg tudja növelni a zajt. Ebben mondjuk az IDE-k fogyatékossága sem sokat segít. Oké, össze lehet csukni, de macera. Sokkal kulturáltabban nézne ki, ha vizuálisan úgy jelennének meg, mint pl. Wordben a megjegyzések a margón a korrektúra módban.
PHP esetén külön borzasztó, hogy igazából a PHPDoc az részben a nyelvi elemek hiányosságainak pótlására kell. Pl. hogy jelölhessem egy-egy adattag/paraméter típusát, hogy működjön Eclipseben az autocomplete (ami nem picit dobja meg a hatékonyságot).
----------------
Lvl86 Troll, "hobbifejlesztő" - Think Wishfully™