RE: Documentaion Services

["Stone, Brad V (TC)" <bvstone@xxxxxxxxxxxxxx>]

Gee, Tim.  I'm glad I didn't work for you.  My idea of commenting and
yours might clash, and I would have been fired for this?  What if I had
experience and developed my own style that might actually help your
staff?  
Do you fire people for redundant or overcommenting?  I am actually
having a blast "De-Commenting" a software package that I am rewriting.  

 * Add 1 to x
C               ADD             1               X
 
It's crap like that.  Even in the file specs.

 * ITEM1 - Item logical 1, keyed by item number
FITEM1          IF              K       DISK

I'd like to look through your source.  No hardcoding anywhere?  I don't
believe that for a second.  It would be nice, but sometimes.. well.. it
just doesn't work out like that.

I hope that you were getting at _documenting_, not commenting.  I could
see how if you write an application and don't document what it does,
there could be a problem.

Happy day.  Have a summer.
  
Bradley V. Stone        
bvstone@taylorcorp.com
http://prairie.lakes.com/~bvstone/
"She's into Malacas, Dino."

> -----Original Message-----
> From: Tim Truax [SMTP:truax@usaor.net]
> Sent: Tuesday, May 19, 1998 3:55 PM
> To:   'MIDRANGE-L@midrange.com'
> Subject:      RE: Documentaion Services
> 
> On Tuesday, May 19, 1998 2:50 PM, Joe Giusto [SMTP:JDG@patuxent.com]
> wrote:
> > Can anyone recomend a company that provides User and Technical
> > documentation of existing in-house applications?
> >
> Joe,
> I have never heard of a company that will do this.  It is however sad
> that 
> people who actually call themselves "programmers"  cannot be relied
> upon to 
> place comments into their programs.  I personally in the past was 
> responsible for hiring programmers, and one of the things I would tell
> a 
> newby was if I find that you are not commenting your code, or if you 
> hardcode...you will be fired post haste.
> Tim Truax
> +---
> | 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 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
+---