DEV Community

Discussion on: What are some "classic reads" in programming?

 
eddycorderol profile image
Eddy Cordero

Comments are really good when they evolve with your code.

But I want to say that when I start working as a developer, my pull requests were full of similar comments, rename this variable or delete this space and a coworker recommends "Clean Code" and this book helped me change this .

Thread Thread
 
aimerib profile image
Aimeri Baddouh

I see! Yeah, in that situation, I completely agree that comments were probably not super helpful.
I've found that in my own experience, PR and code comments aren't a good way to explain the code itself as it quickly gets stale and comments go out of sync with the code they are for.