“Comments are – at best – a necessary evil” (Uncle Bob, “Clean Code”) – Over the years I gathered quite a collection of examples for bad code comments. The most precious gems among them I would like to share with you. You will listen in on developer monologues and dialogues, try to analyze cryptic bylines, experience different levels of UnCamelCasing(tm) skill and fight your way through a redundant, useless and misleading inline thicket. You will also hear about well-meant tools and plugins that should not even exist if the motto “No Comment!” would be valued as it should be.
You can find the original presentation slides here: http://no-comment.kimminich.de
Some comments on // No Comment! from Clean Code Days 2015:
@bkimminich is killing the crowd @Clean_Code_Days. “Phil added this method. Thank you Phil – Rob” ROFLMAO pic.twitter.com/FVxLHmfyvT
— Ittai Zeidman (@ittaiz) 5. November 2015
@bkimminich speakes out against “UnCamelCasing” comments @Clean_Code_Days pic.twitter.com/SBv1ReeT4K
— David Völkel (@davidvoelkel) 5. November 2015
Thx @bkimminich for your awesome //no comment talk. Have never loughed so much during a talk! pic.twitter.com/2m9Agfy0Hx
— David Völkel (@davidvoelkel) 5. November 2015
@bkimminich with “scientific” evidence on why comments are bad. This one via @SonarQube pic.twitter.com/GNIqj3vKEw
— Ittai Zeidman (@ittaiz) 5. November 2015
Now @bkimminich talking about (no) comments at @Clean_Code_Days! 😀 pic.twitter.com/QSDdIMBAA7
— Miguel Grazziotin (@Miguelgraz) 5. November 2015