DEV Community

Discussion on: Best Practices for Code Documentation and Comments: A Guide for Budding Programmers

Collapse
 
stacy-roll profile image
Stacy Roll

I still don't make any comment inside my code because i write it clear. Just junior and trainee make use comments

Collapse
 
alinp25 profile image
Alin Pisica

Agree to disagree. I love clean code that is not commented. I do not love people who do not add comments just because they think that they write clean code. Yes, as long as everyone is on the same page with the coding style and can be easily understood, comment's are useless, but I would rather have some than none, and I can easily disable them through extensions.

Collapse
 
jakeespinosa profile image
Jake Espinosa

Like the commenter above, agree to disagree. Comments shouldn't be overused (and often are), but using them to explain complex code that can't realistically be simplified is a good practice. I'd also argue docstrings are a great thing to have in your code.