Code should be the one version of the truth, don’t add comments

 

“Code never lies; comments sometimes do.” — Ron Jeffries

Code should be self documenting, the purpose of classes, methods and variables should be obvious that you can understand it in six months time.

The reason I don’t like comments in code is because you have to maintain the code and the comments. I have seen examples where developers have changed the code but not…

Continue Reading Hosk’s Article on their blog

Code should be the one version of the truth, don’t add comments

“Code never lies; comments sometimes do.” - Ron Jeffries Code should be self documenting, the purpose of classes, methods and variables should be obvious that you can understand it in six months time. The reason I don’t like comments in code is because you have to maintain the code and the comments.

Blog Syndicated with Hosk’s Permission

Author: Ben Hosking

Share This Post On
Share via
Copy link
Powered by Social Snap