I agree. I comment my own code pretty heavily, even when I’m the only person who reads it.

Our industry is into fad following, and once a few of the current greats decide something is bad, time to run in the other direction and eliminate it everywhere we can.

When I was taking Computer Science, they were still advocating needing pre and post condition comments and a paragraph on every function. I thought it was too much. Nowadays, we’ve largely moved that into tests.

I don’t think this current fad of basically having to justify having a comment is sensible either. Like most of these things where they go too far, they are often promoting some good ideas. While I think good variable and function naming can substantially reduce the need for comments, I’m not dogmatic about not using them.

Show your support

Clapping shows how much you appreciated Mark H’s story.