DEV Community

Discussion on: Removing Comments

mighty_squash profile image
jonathan edwards

I agree that more meaningful comments are necessary and that returning to your code periodically to see if they still apply is important. But like one other person has said, incorrect or suspicious comments have forced me to pull out my hat and magnifying glass to see if its accurate and, if necessary, fix issues before they present themselves as bugs. At that point I would suggest that you correct the comment to describe what is really happening.

In my field we have so many convoluted object names that going off of those alone is not enough for a new developer to understand the business logic. A good combination of well-maintained comments and proper javadocing can save a new team member a good deal of time.