Every Comment is an Admission of Failure. Write self-documenting code instead.(blog.weaponizedgames.com) |
Every Comment is an Admission of Failure. Write self-documenting code instead.(blog.weaponizedgames.com) |
"The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means."
I agree with Knuth. All my blog post is saying is that, given that a program is little more than a bunch of words (symbol names), we might as well make those words be the documentation instead of cluttering up the screen with more words that we call comments.