DEV Community

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

Collapse
 
clovis1122 profile image
José Clovis Ramírez de la Rosa

Good stance Corley!

Inside functions I also tend to leave code for readability, hacks, todos and even something like moment(date, 'MM/DD/YYYY').format('YYYY-MM-DD') to explain "why" that was done. People argue that comments can hurt readability but I haven't found such case yet.

Collapse
 
terrancecorley profile image
Terrance Corley

Thanks!

Yeah I agree. If it makes it easier to understand the "why" behind the code at a quick glance- especially if it's an older project you're coming back to after some period of time, I don't see any issue with it. As some others have already said, just don't go crazy with the comments.