I hardly ever comment my code and the documentation I DO write sucks bigtime... There, I said it... happy now?? :))
Like mentioned before commenting code should be a reflex, and someday I will train it. Right now I'm lazy (and Larry said Laziness is a virtue). I doubt you can have TOO much documentation, like you can't have TOO much sex (hear that, hun??) or TOO much O'Reilly (Manning too) Perl books.
I get comments constantly for not providing documentation and POD for my code/apps; my excuse usually is something like 'But it's still beta... I'd be a fool writing documentation for code that's probably gone change anyway...'.
If New Year were today, my New Year's resolution would definitly include writing more documentation and POD, together with finally security checking code, bribing
vroom with beer again and slowing down my XP gaining so
OeufMayo can catch up.
Greetz
Beatnik
... Quidquid perl dictum sit, altum viditur.