loading...

re: Removing Comments VIEW POST

FULL DISCUSSION
 

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.

code of conduct - report abuse