From: firth@sei.cmu.edu (Robert Firth)
Subject: Re: Lines of documentation per LOC
Date: Wed, 26 Oct 1994 15:22:01 EDT
Date: 1994-10-26T15:22:01-04:00 [thread overview]
Message-ID: <1994Oct26.152201.10969@sei.cmu.edu> (raw)
In-Reply-To: 1994Oct26.094543.24213@sei.cmu.edu
In article <1994Oct26.094543.24213@sei.cmu.edu> lpb@sei.cmu.edu (Loic Briand) writes:
>Robert, I am not totally stupid. I _know_ that the amount of documentation is
>function of the code. The problem is that when you have a client who ask for
>10 lines of doc par LOC and you have budgeted 0.1 (based on the expected
>complexity of your code), you have to prove your point.
Suggestion: write a code reformatting tool that will copy Ada code
and join or split lines of comment to meet any required comment
density. Then write the code and comment it properly. Then use
the formatting tool to give you the number of lines of comment
you need.
The best weapon against the ridiculous is ridicule. Always will be.
next prev parent reply other threads:[~1994-10-26 19:22 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
1994-10-25 21:00 Lines of documentation per LOC Loic Briand
1994-10-25 19:00 ` Robert I. Eachus
1994-10-26 13:45 ` Loic Briand
1994-10-26 19:22 ` Robert Firth [this message]
1994-10-26 22:30 ` Robert Dewar
1994-10-27 14:55 ` Norman H. Cohen
1994-10-29 10:42 ` mat
1994-10-29 10:32 ` mat
-- strict thread matches above, loose matches on Subject: below --
1994-12-07 12:57 Loic Briand
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox