DEV Community

Discussion on: Should comments in code be considered failures in coding?

Collapse
 
albindevs profile image
Albin Daniel Garcia

Well, I'm just a beginner. I've gone through some interesting github projects with really large code base, lots of files and I can tell that what stands out the most are the good descriptive comments that tell you what the file or function is, what it does, how it's used and so on.

Sure, the less comments the better. Good expressive code is essential for writing clean code. But comments are a faster way to help developers get a better understanding among lots of code.

If you don't write any comments at all, I think you're not considering other developers

Collapse
 
rossdrew profile image
Ross

But surely adding comments is placing more of a burden on developers. Now in addition to maintaining the code, there is a requirement to maintain comments.