DEV Community

Discussion on: Soft(er) skills that make you a better programmer

Collapse
 
josegers profile image
Jo Segers • Edited

The fact that you need to write comments is an indication that your code itself is not clear enough.

Remember that comments need to be maintained and refactored with the code. An out of date comment is worse than no comment at all.

I prefer restructuring/renaming code until it is clear what it does instead of commenting difficult parts.