Path: utzoo!mnetor!uunet!husc6!mailrus!ames!umd5!uvaarpa!virginia!uvacs!hsd
From: hsd@uvacs.CS.VIRGINIA.EDU (Harry S. Delugach)
Newsgroups: comp.software-eng
Subject: Re: American Programmer
Message-ID: <2350@uvacs.CS.VIRGINIA.EDU>
Date: 11 Apr 88 13:18:48 GMT
References: <87@studsys.mu.edu> <3850007@wdl1.UUCP>
Reply-To: hsd@uvacs.cs.virginia.edu.UUCP (Harry S. Delugach)
Organization: U.Va. CS dept.  Charlottesville, VA
Lines: 20

In article <3850007@wdl1.UUCP> rhj@wdl1.UUCP (Bob Jones) writes:
>Some observations on commented code:
>
>Adding comments as you go is the only way to fly. It may require a
>small amount of additional time up front, but the payoff is huge down
>the road.  Poorly commented code is, in my personal opinion, one of 
>the key indicators of an immature and impatient programmer.

What about short-sighted, "bottom-line" oriented company management which
forbids you to "waste" time creating obviously non-functional comments,
particularly if the project is perceived as easy or a 
"one-shot deal". Later when the "one-shot" is revived or modified, 
your new boss wonders why in the world you didn't forsee that it would
be re-used. In such a case, it is often true that the real culprits
(former managers) never have to face their mistakes.
-- 
Harry S. Delugach   University of Virginia, Dept. of Computer Science
                    INTERNET: hsd@cs.virginia.edu
                    UUCP: ..!uunet!virginia!uvacs!hsd
                    BITNET: hsd2x@virginia