3 ms·
What I don't like is code where comments explain obvious things. Code should be speaking for itself. This is an easy demand for pure administrative code ("high
by ktpsns 7y ago
What I don't like is code where comments explain obvious things. Code should be speaking for itself.
This is an easy demand for pure administrative code ("high level" or how you want to call it) in an expressive language. Once it comes to the heart of the matter, such as a challenging algorithm which is hard to follow, I like extensive comments about the meaning of variables, etc.
Interestingly, people comment trivial stuff but don't comment the complex ones. That's a natural phenomena called Parkinson's law of triviality.