Brad Touesnard is a WordPress developer, designer, podcaster, and founder living in Halifax, Canada.


Stop commenting your code just to say you did

Summary – Code comments that point out the obvious make the important comments harder to spot. Developers are better off when there are only a few comments for the code that deserves an explanation.

5799338412_70bd536ff1_bYou open up an electrical box and see a few hundred wires. Lots of different colours that don’t mean a heck of a lot. But someone has put a neat little label on every wire. Awesome!

Or so it seemed until you actually start looking at the labels. Almost all of them are blank!

So you spend an hour digging through every label. In the end, you find a total of 12 actually written with an important message. Hopefully you didn’t miss any in all the chaos.

This is how I feel when I dig into code with useless comments everywhere. It’s hard to identify useful comments in the sea of useless ones. Needles in a stack of needles.

Read More ►

Recent Blog Posts

More Posts ►


Latest Tweets

More Tweets ►


Fishing Boats, Havana, Cuba

Fishing Boats, Havana, Cuba

Mar 30, 2011

Fountain, Havana, Cuba

Fountain, Havana, Cuba

Mar 29, 2011

Blomidon National Park, NS, Canada

Blomidon National Park, NS, Canada

Sep 7, 2010

Notre-Dame Basilica of Montreal

Notre-Dame Basilica of Montreal

Aug 12, 2010

Mount Ruapehu, New Zealand

Mount Ruapehu, New Zealand

Dec 9, 2009

More Photos ►