Comment on My Case Against Code CommentsComments−abecedarius15yNobody writes clearer code than Peter Norvig, yet he usually gives everything a line-or-so doc comment -- e.g. http://norvig.com/lispy2.html. That's pretty far from the comments-should-be-rare credo. I like it.My actual argument for that style sans appeals to authority: http://stackoverflow.com/questions/499890/what-is-your-perso...−knieveltech15yWorthy of a standalone post somewhere so I can add it to my bookmarks. :)−abecedarius15yThanks -- maybe I'll get to it soon.
Comments
Nobody writes clearer code than Peter Norvig, yet he usually gives everything a line-or-so doc comment -- e.g. http://norvig.com/lispy2.html. That's pretty far from the comments-should-be-rare credo. I like it.
My actual argument for that style sans appeals to authority: http://stackoverflow.com/questions/499890/what-is-your-perso...
Worthy of a standalone post somewhere so I can add it to my bookmarks. :)
Thanks -- maybe I'll get to it soon.