• Subject: RE: what is unclear about 01 02 03 -Reply
  • From: Buck Calabro <mcalabro@xxxxxxxxxxxx>
  • Date: Wed, 6 May 1998 11:21:15 -0400
  • Organization: commsoft

On Wednesday, May 06, 1998 9:17 AM, Scott Swaim [SMTP:scott71@hpnc.com] 
wrote:
>     With all of this talk about proper coding I have not seen one 
mention
>     of comment your code for "Others".
>     This is just an observation.

Scott, you are 10000% correct!!!!
We try to get our people to write their comments first, then write the 
code around the comments.  That way, the comments are not simple repetions 
of the code like:

C            Exsr      Warn                                 Warning 
subroutine

but more like:

 * Send email to end-user telling them about their depleted credit line
C            Exsr      Warn

It's far from perfect, but it does help!
I'm hoping that the lack of remarks about comments are because we already 
have good comments in our new code; it's just the legacy stuff that's a 
problem. <big grin!>


Buck Calabro
Commsoft, Albany, NY
mailto:mcalabro@commsoft.net

+---
| This is the Midrange System Mailing List!
| To submit a new message, send your mail to MIDRANGE-L@midrange.com.
| To unsubscribe from this list send email to MIDRANGE-L-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---


This thread ...


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

This mailing list archive is Copyright 1997-2019 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].