My subjective opinion is that we shouldn't use any comments in the committed codebase. Main reason is that there is no way to validate the comment if it's correct. Compiler doesn't care about it, testers don't care about it, even developer don't bother them self's to change the old comments when change the code. At the end you never can trust the comment and still need to read code. If you can't understand what the code is doing, then how you are going to change it, you are the right person for that job.
Noone mentions the Clean Code book here?
Thank you! 😎
My subjective opinion is that we shouldn't use any comments in the committed codebase. Main reason is that there is no way to validate the comment if it's correct.
Compiler doesn't care about it, testers don't care about it, even developer don't bother them self's to change the old comments when change the code.
At the end you never can trust the comment and still need to read code.
If you can't understand what the code is doing, then how you are going to change it, you are the right person for that job.