DEV Community

Discussion on: 7 Tips For Clean Code

Collapse
 
pradeepradyumna profile image
Pradeep Pradyumna

Good article!

Point 1 & 2 sometimes go hand in hand.
For brevity if methods/ classes are named such that they are very much self explanatory, then comments won't be necessary. For instance, if a method name says ValidatePhoneNumber(), then I refrain from writing a comment on top of it, saying // Validate phone number.

Collapse
 
akashshyam profile image
Akash Shyam

Thanks mate! I agree with you completely, which is why I gave an example regarding how not to comment.