I saw a button at "ThinkGeek.com" that once said:
"Real programmers don't document - if it was hard to write it should be hard to understand."


I'd say when it comes to commenting code, the more the merrier.
I can't say I've ever had anyone complain that I use too many comments.

Jason Abreu
Abreu Innovations, Inc.

On 2/28/2011 12:56 PM, Richard Schoen wrote:
My two cents:

My personal preference is to document as many lines as possible, even if they may be seemingly obvious.

Others may feel that code is self-documenting when often-times it's not because of terse naming or other attempts to write multiple code lines as a single statement.

Maybe it's my fascination with re-stating the obvious, but I think in English whereas some think in code :-)

Richard Schoen
RJS Software Systems Inc.
Where Information Meets Innovation
Document Management, Workflow, Report Delivery, Forms and Business Intelligence
Email: richard@xxxxxxxxxxxxxxx
Web Site: http://www.rjssoftware.com
Tel: (952) 736-5800
Fax: (952) 736-5801
Toll Free: (888) RJSSOFT


message: 5
date: Mon, 28 Feb 2011 09:20:51 +0100
from: Thorbj?rn Ravn Andersen<thunderaxiom@xxxxxxxxxxx>
subject: RE: Is String.split() broken?

Hi Joe.

I am not interested in a code style war, but I am - sincerely, honestly -
interested in hearing why people choose to do it this way (because I
inherited a large codebase in this style). Thanks for a thorough answer.

If others do this kind of commenting, I would appreciate hearing why they
have chosen to do so :) Again, not for the code war, but to become a little
more educated.

As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2021 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.