How to Comment Code Better

August 01, 2005

Ryan Campbell has posted some good tips on practical approaches to writing better comments.

His article should help you find the median between over commenting, and not commenting enough.

Commenting your code is like cleaning your bathroomyou never want to do it, but it really does create a more pleasant experience for you and your guests...

there are a lot of tough, but fundamental questions out there like what does "frequently and appropriately" mean? Because there are a million different beliefs and contradictions on the subject, I created this brief overview to present my findings

Like this? Follow me ↯

You might also like:

5 people found this page useful, what do you think?


"placeholders" like hint and displayName are (IMHO) a great backhand way of commenting code. I'd just like to see a hint attribute on cfparam (any chance, do ya reckon?) my 2c barry.b
Hi, I ws searching everywhere for this particletree article, but they all are just links to the same one, which is missing now. Do you have the article in complete? or atleast where can I find it?
A search on Particle Tree yielded the following:
Pete: <quote> Commenting while you code forces you to make sure your logic ?sounds right.? Plus, your comments are going to be more accurate when the understanding of what?s going on behind-the-scenes is fresh in your mind. </quote> has writing pseudocode beforehand fallen out of favour? do ppl no longer map out what they want to do (in pseudocode), use that as comments in the source and then add real code around it? are all my habits (that have served me well) now "old hat"?

Foundeo Inc.