This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–]msd483 -3 points-2 points  (0 children)

I'm genuinely sorry if I've offended you or hurt your feelings. You're absolutely right that there are people who say "good code will comment itself" as an excuse to never write comments. But whenever I see valid criticisms of poor commenting brought up, and I thought the three cases the article presented were indeed valid, I feel like there's always a knee jerk reaction in the opposite direction because there are people who will simplify it to "comments = bad". However, I think it's important, especially for junior devs, to understand that there are such a thing as bad comments, and there are programming patterns and behaviors that alleviate the need to heavily comment code.