Nov 26, 2021
I really wonder where people encounter these developers with excessive comments. I cannot remember seeing that since college days. In general people comment and document far too little.
People can make peculiar choices in their code and it becomes impossible to guess why those choices got made without comments.
And functions which are not obvious how to use ought to be documented. What is valid inputs? What can we expect as output?