Commentless Code is not a Silver Bullet

He doesn’t say it is a silver bullet, but Jeffrey Palermo has blogged that limiting code comments increases maintainability. This is definitely something I’ve tried to impress on my current team members. I would only like to add one point, and that is that the approach doesn’t automatically mean your variable names stay relevant.

Maintenance developers will still be able to change the semantic meaning of the variables. Do you really think they’re going to bother changing the name of the variable?

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: