Quote Originally Posted by Whacker
//lots of nicely commented code
Now that's the way to properly document code!

doc_bean: I'm sure you have, and I'm sure you will be again, mate. Nothing wrong with venting.
Also, if you wanna look for the silver lining, I can clearly remember a situation where I was using some code that I wasn't sure what was supposed to do exactly... and it had some comments (not much, but I thought, hey, better than nothing)... it was all a bit complicated, not trivial, obvious code. So I went by the comments, but the stuff wasn't working as it was supposed to.
After looking, and looking, several days wasted, I figured out what the problem was. The problem was that the authors of the code did not have English as their primary language, so what they probably meant to write was the actual opposite of what they had written... In other words, the comments were blatantly wrong...

Morale of this story: sometimes, no comments is better!