Code has lots of comments.
Comments are coupled to implementation and hardly maintained.
- Obsolete Documentation
1) Refactor methods.
2) Rename methods to more declarative ones.
3) Break methods.
4) If a comment describe what a method does, name the method with this description.
5) Just comment important designs decisions
Linters can detect comments and check the ratio comments / lines of code against a predefined threshold.
This article is part of the CodeSmell Series.