DEV Community

Discussion on: 10 Principles of a Good Code Review

Collapse
 
minompi profile image
AlessandroMinoccheri

Wonderful article, I absolutely share It!
The only point that I disagree is principle 4 because I don't like comment, your code needs to be clear to all, clean for a good code review.

Don't use comments please

Collapse
 
codemouse92 profile image
Jason C. McDonald

There are people who disagree w/ commenting in general, but the proof is in the pudding. Our ROI on intent-commenting has been tremendous: we've saved so much time and caught many bugs using them.

Read Your Project Isn't Done Yet for a full explanation of why intent comments are so vital to good code.