DEV Community

Discussion on: I love to document my code. Am I doing it wrong?

Collapse
 
nateous profile image
Nate

They call them programming languages for a reason. You learn how to read and write in them. I'm in favor of less comments, more readable code.

Over time the code will change, and to my knowledge there aren't many tools that can ensure your comments match your code.

And if the code you're writing or reading needs to be commented so heavily, I'd question if it couldn't be rewritten.

Can you share with us an example method with comments?