News for hackers. Stuff that matters.
Re:Block Comments Are a Bad Idea by StavrosK on Wednesday October 11, 2017 @08:17AM (#15449113)
It's kind of surprising to me that anyone past junior-level development doesn't already have it hammered into them that "code is how you did something, code is why you did it".

Also, if you can't possibly be any less clever in your code, then leave a comment explaining the "how", and apologize that you couldn't make it any simpler.

Re:Block Comments Are a Bad Idea by wruza on Wednesday October 11, 2017 @12:15PM (#15450873)
s/code is why/comment is why/, I think?
Re:Block Comments Are a Bad Idea by StavrosK on Wednesday October 11, 2017 @12:41PM (#15451067)
Doh, sorry, you are correct. I can't edit the comment any more, unfortunately.