News for hackers. Stuff that matters.
Re:My Case Against Code Comments by dwc on Saturday December 18, 2010 @08:42PM (#2020805)
I comment for "me in six months" and that works ok. Not perfect, but ok. Nothing says "unthinking clod" to me like a few thousand lines of code with comments where I'm told that i is a loop index.
Re:My Case Against Code Comments by knieveltech on Saturday December 18, 2010 @09:01PM (#2020845)
I don't think anyone is advocating for comments explaining that $i is a loop index.
Re:My Case Against Code Comments by dwc on Saturday December 18, 2010 @11:30PM (#2021098)
I don't think so either. But that's what comes out of Thou Shalt Comment. And yes, I have seen loop index comments. Haven't you?

I think we'd both agree if we saw a good comment. I just want to focus on the 'good' part rather than the 'comment' part.

Re:My Case Against Code Comments by knieveltech on Sunday December 19, 2010 @12:53AM (#2021212)
Of course I've seen loop index comments, and redundant variable declaration comments, and all manner of bad commenting. Thing is, I'll take a bad comment over blank code any day.

Crap comments warn me ahead of time that I'm dealing with a developer who's either too inexperienced to know how to comment well or too sloppy to do a good job at it and in either case I need to be paying closer attention to their code than I might otherwise.