The Commento

• I want to suggest a commenting standard for our projects. Some barely comment their code, and everyone knows that code without comments is unreadable.

• Comments are academic panacea. Everyone doing real programming knows that comments make code harder to read.

• Yes, it's harder to read because it is more to read.

• But good comments are worth their weight in gold. Having had both, I would rather maintain code with comments than without.

• A good programmers code should be self-documenting.

• But what is meant to happen is not in the code...

• Why don't you try to read your own self-documented code one year after you wrote it?

• But what about changes? Even I know that nobody updates their comments...

• Actually, a disagreement between code and comments means that both are wrong!

• I think we shall encourage commenting, but we won't be naive about it.