DEV Community

Discussion on: I love to document my code. Am I doing it wrong?

Collapse
 
mohamedboualleg profile image
Mohamed Bouallegue

Relying on comments will make it easier for developers to write bad code since they can always explain in comments how it works. With practices like this, developers will not even notice that their code is badly designed.
Avoiding comments will push the developer to rethink and improve his code rather than explaining why the code is complicated.