By John Sonmez February 13, 2014

Should You Comment Your Code?

Most beginning software developers think it is a good idea to put lots of comments in their code. When I first started out in software development, I probably wrote 3 lines of comments for each line of real code. But, the problem with this approach is that comments aren't living and code is. One changes the other grows stale.
Instead, it is better to write clear expressive code that describes itself so well that it doesn't need comments.
In this video I talk about why I try to avoid using comments in my code and why I think you should too.

 

Full transcription below

show

About the author

John Sonmez

John Sonmez is the founder of Simple Programmer and a life coach for software developers. He is the best selling author of the book "Soft Skills: The Software Developer's Life Manual."