× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.



On Fri, 23 Mar 2012 09:13:33 +0100, Dave wrote:

Hi,

Where do you all put your comments on your sub-procedures? In the
prototype, or in the procedure itself?

I put a high level description in the prototype and the same text at the
top of the method body. Then I comment each block of code verbosely. It's
amazing how helpful that is a year or two later when a change is needed.
I don't care how descriptive the variable and constant names are (and
they should be.) Comments are essential. Why in the world did I do that?
Oh, yeah, there it is. Sometimes I impress myself. Sometimes not, but at
least I know why...


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-2024 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.