News for hackers. Stuff that matters.

A comment on Coding Without Comments. Parent comment

Re:Coding Without Comments by spydez on Friday July 25, 2008 @12:26AM (#256300)
My favorite comment that I've personally written:

    // Here there be magic. See datasheet for details; they explain it 
    // almost as well as I just did.
(followed by ~10 lines of math chock full of magic numbers.)
[ Parent | on HN ]
Re:Coding Without Comments by jgrahamc on Friday July 25, 2008 @05:29AM (#256439)
I maintained a piece of 250,000 line C code that had one comment in it (apart from copyright notices):

/* bad code */

To this day I do not know if this was a comment on the quality of the code that came after it, or if the developer was reprimanding the code.

[ Parent | on HN ]