Ideally code should be neat, clean and odorless. But in real world we everyday work with a mass of ugly and smelly commented code.
I have five reasons to avoid comments:
Comment is a waste for compilers.
Nobody will support comment written once. It most likely will become smell and create misunderstanding in the future.
The more comments the more enormous modules we have.
Comment means that code is complicated.
Better comment is a meaningful name for variable, function or class. You can extract some code part to them to explain how this part works.
Let’s create a clean self-explaining code:
Explain yourself in code ☺️ #cleancode pic.twitter.com/UlpipWO3Oq— David Santos (@dsantosmerino) April 23, 2017