DEV Community

Discussion on: How To Write Comments

Collapse
 
hsalem profile image
Hassan

Nice article. For me, I don't encourage adding comments at all :D. Because I feel they are an acceptable workaround for writing unclear code 🙉, and that is why I totally agree with you on the first point.

But the only case I would write a comment is when the intention behind adding this function or functionality is ambiguous. So in a short sentence, I would add comments about "why" I wrote something instead of "what" I wrote.

Collapse
 
muhimen123 profile image
Muhimen

I don't write comments when I am coding either 😋
But when I am done writing, I review the code and then comment out some unclear parts.