From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=BAYES_00,INVALID_DATE autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,350d56069dc98b72 X-Google-Attributes: gid103376,public X-Google-Thread: f43e6,350d56069dc98b72 X-Google-Attributes: gidf43e6,public X-Google-ArrivalTime: 1994-10-26 13:35:26 PST Newsgroups: comp.lang.ada,comp.software-eng Path: nntp.gmd.de!newsserver.jvnc.net!howland.reston.ans.net!math.ohio-state.edu!magnus.acs.ohio-state.edu!cis.ohio-state.edu!news.sei.cmu.edu!firth From: firth@sei.cmu.edu (Robert Firth) Subject: Re: Lines of documentation per LOC Message-ID: <1994Oct26.152201.10969@sei.cmu.edu> Sender: netnews@sei.cmu.edu (Netnews) Organization: Software Engineering Institute References: <1994Oct25.170005.27711@sei.cmu.edu> <1994Oct26.094543.24213@sei.cmu.edu> Date: Wed, 26 Oct 1994 15:22:01 EDT Xref: nntp.gmd.de comp.lang.ada:16210 comp.software-eng:19222 Date: 1994-10-26T15:22:01-04:00 List-Id: 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.