Comments on code...

Inspired by Jay Kimble's post “Real Programmers... don't use comments??!!, I want to say my personal opinion about comments in code.

I think that code (expecially if it's part of a big project) must always be well commented. A "well commented" code is more simple to understand for others and more simple to maintain.

I'm totally disagree with the affermation that “comments are useless; if you can't read my code and understand it, you shouldn't be in it.” ... for me this is terrible wrong.

Comments are useful for the program's author when he has to do some modification on the code and a lot of time is passed from the last revision (my personal experience says that reading good comments is fast than try to understand all the code) and it's extremely important for other people that could work with your code.

If you have a big project and work in team, a "well-commented" code is foundamental. Other programmers must understand not only your code, but the idea associated with your code (function, routine etc.).

Comments are the only way to clearify your idea... so, my advice: "Real Programmers, please use comments!!!"

Print | posted on Saturday, May 15, 2004 9:27 AM

Comments on this post

# re: Comments on code...

Requesting Gravatar...
I'll have to disagree. Real Programmers...

http://www.melloblog.com/Feedback.aspx?BlogID=60
Left by michael on May 15, 2004 7:32 AM

# re: Comments on code...

Requesting Gravatar...
Real programmers write code directly to their hard disk using magnetic cores :D
Left by Genesio on May 15, 2004 10:19 AM

# re: Comments on code...

Requesting Gravatar...
Real Programmers don't use useless comments, but they certainly comment. It's easy for the creator to understand their code, but people do have different approaches to coding and we all do things differently, assuming everyone does everything the same way as you is a little arrogant I'd say.

I am in with the commenting crowd and your comments here are spot on.
Left by Mavrick on May 17, 2004 4:42 AM

Your comment:

 (will show your gravatar)
 
Please add 8 and 3 and type the answer here: