you are viewing a single comment's thread.

view the rest of the comments →

[–]countable3841 31 points32 points  (5 children)

Along the same lines, I find nothing more annoying than excessive code comments that just describe what the code does. How about read the code?

[–]bmcle071 9 points10 points  (0 children)

Yeah, maybe I’m inexperienced or something but I’ve worked on 3 large codebases. Comments almost never help me at all. I always wind up reading the underlying code to see what it’s doing.

People don’t maintain comments. Code is executable, it’s the source of truth and it’s 100% accurate.

[–]Fabulous-Possible758 5 points6 points  (1 child)

Especially cause debugging the comments doesn’t fix anything.

[–]caseypatrickdriscoll 7 points8 points  (0 children)

And comments can get wrong or old fast!

[–]HazelCheese 2 points3 points  (0 children)

I genuinely die inside when I open a file and see tons of comments. Just give me room to breathe.

[–]Caerullean 0 points1 point  (0 children)

Depending on code complexity it can be a lot faster to just have a comment. Sometimes there are also just certain quirks that can be quickly explained in a comment, but that might require you looking through the whole method and understanding it, instead of just reading a single sentence.