DEV Community

Discussion on: 7 Tips For Clean Code

Collapse
 
akashshyam profile image
Akash Shyam

Sometimes we just can't help it. While using a 3rd party library, it might have confusing names or methods which can't be understood without referring to the docs.

Collapse
 
mhmxs profile image
Richard Kovacs

You are right, but docs and comments are two different things. Function needs some documentation to understand the reason. But leaving comments everywhere doesn't make sense.

Thread Thread
 
akashshyam profile image
Akash Shyam

Exactly, It is exactly what I mentioned in the post