News for hackers. Stuff that matters.
Re:Yes, your code does need comments. by Joeri on Thursday March 07, 2013 @03:53PM (#5340167)
I don't agree with this definition of intent. For me intent is about why a piece of code is written the way that it is, which is also what the article itself equates it to.

Also, I don't think you can write many useful comments when returning to a piece of already written code. The only way to understand the why of a piece of code is to trace all its implications, and it is not efficient to make that sort of investment after the fact. The easiest way to produce high quality comments is to write them during the act of programming.

There are no comments on this comment yet.