2 ms·
Your example doesn't make sense to me. If I see a comment that says something different from what the code does I assume that the comment is wrong and I do a si
by tigershark 10y ago
Your example doesn't make sense to me.
If I see a comment that says something different from what the code does I assume that the comment is wrong and I do a simple blame that will show me the jira that has been implemented in that code to double check.
For sure I don't need to read all that is specified in the Jiras whenever I look at any piece of code.
The code explains itself quite well.
If you write code that is not understandable then that is the problem, and adding thousands of comments in the form of documents will only make the things worse instead of solving your problem.