DEV Community

Discussion on: The Importance of Quality Comments

Collapse
 
computer_paul profile image
Steve Shapero

Bad code as in the example is about 1000x more important to fix than the comments. Comments feels like bike-shedding. I discourage comments and discussion of comments because I find most times effort is best spent on getting rid of bad code, of which there is always plenty to get rid of. Write fluent APIs, write good tests, and most developers -- even those who don't know the language or the problem (as is the case with the Go example) -- will figure it out in 10s or less.