in reply to Too much documentation?

Although I do comment complicated things, I actually tend to use comments to tag what happens in blocks of code. I generally find that comments end up being really redundant to anyone with a fair ammount of experience. Thus I tag blocks so I can just read the block comment header to find if that is the section of code that I want to look at.

And yes, that's a bad way to do it! With Perl I think more comments are better, unless you start commenting things like
$i++   # incrament i