There’s comments, and then there are comments…
I mean, you comment your code, the code that most likely only you will be dealing with, so that you can figure out what the heck you were thinking/doing/etc. when you look at that code months later, right? And those comments make sense to you, at least you hope. I mean, you wrote them!
Then there’s the case where that same code has to go to someone else, and you end up adding a million more comments in the hope that what you wrote makes sense to that someone else. Someone who isn’t really as versed in Perl (or whatever language) as you probably are. Hurm…
There goes all my scripts that were nice and compact at under 500 lines of code. Well, actually, they’re all still under 500 lines of actual code, I’ve just added 100 lines of comments, or so it seems…