News for hackers. Stuff that matters.
Re:Portrait of a N00b by berntb on Sunday November 13, 2011 @12:19PM (#3231198)
Well, you're right.

Personally, as long as the tests worked, I'd just read the documentation string. (My gut reaction of happiness to see a doc string probably means that I should update my CV. 1/2 :-) )

Re:Portrait of a N00b by Meai on Sunday November 13, 2011 @01:34PM (#3231408)
Yes and that is exactly the point of comments: to make reading code as unnecessary as possible. The base assumption (and reality) should be that every function is working perfectly. People who criticize the existence of too many comments seem to want to read code too often.