RE: what is unclear about 01 02 03 -Reply

[Buck Calabro <mcalabro@xxxxxxxxxxxx>]

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
+---