DEV Community

Discussion on: To Comment Or Not To Comment?

Collapse
 
ghost profile image
Ghost

And what people seems to forget is: people don't like to write more than necessary. So if someone write a comment s(he) need it or thinks s(he) will, nobody do it to do harm. I like commenting a lot and before commit I check the comments and start trying to remove them, usually shows me that a variable have the wrong name, something is doing something it shouldn't, some language concept is not clear enough to me yet, etc. After this cleanup I naturally endup with very few if any comments and those where the ones I couldn't explain with the code, maybe because I don't understand something yet but all you can do is the best you can do. Being perfect would be very boring.