When you feel the need to write a comment, first try to refactor the code so that any comment becomes superfluous.
Quoted from Refactoring: Improving the Design of Existing Code Page 88arrow-up-right
Also see https://refactoring.guru/smells/commentsarrow-up-right
Last updated 7 years ago