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=1.1 required=5.0 tests=BAYES_20,INVALID_DATE autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: f43e6,350d56069dc98b72 X-Google-Attributes: gidf43e6,public X-Google-Thread: 103376,350d56069dc98b72 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 1994-10-30 02:11:13 PST Newsgroups: comp.lang.ada,comp.software-eng Path: nntp.gmd.de!xlink.net!howland.reston.ans.net!EU.net!uunet!mole-end!mat From: mat@mole-end.matawan.nj.us Subject: Re: Lines of documentation per LOC Message-ID: <1994Oct29.103256.28265@mole-end.matawan.nj.us> Organization: : References: <1994Oct25.170005.27711@sei.cmu.edu> Date: Sat, 29 Oct 1994 10:32:56 GMT Xref: nntp.gmd.de comp.lang.ada:16309 comp.software-eng:19359 Date: 1994-10-29T10:32:56+00:00 List-Id: In article , eachus@spectre.mitre.org (Robert I. Eachus) writes: > In article <1994Oct25.170005.27711@sei.cmu.edu> lpb@sei.cmu.edu (Loic Briand) writes: > > > Is there any document or source of information that provides > > an accepted (?) ratio (lines of documentation / lines of code) for a > > software design document (SDD)? > > Talking with people around me, I got values between 10 and 0.1, > > but no rationale other than: "the description has to be complete and > > sufficient to allow modifications" and stuff like that. > > At first I couldn't believe that this was posted by someone at the > SEI. Then I noticed it was posted by an industrial affiliate, who may > learn something while he is there. And on second reading, I realized > he had gotten the right answers and dismissed them! Maybe he won't > learn after all. If the original poster will look carefully at the `stuff like that,' I belief he will find all the criteria he needs to determine whether the design documents will meet their needs. He has, in other words, a specification for design documents. His job is now to determine what design documents will meet that spec. He's looking for another spec, one that doesn't require him to think, one that doesn't require him to expend engineering effort on every step of the engineering process. It don't work that way. If you get a set of criteria that tell you how to judge your work against the real needs it must meet, treasure them. Paint them on your walls, and repeat them in chant as you enter and leave the office. Begin every design document with page on which those criteria are written. Cherish and apply the wisdom you receive. Or read Schwartzkopf's book, and particularly the section where he has nailed down the five main responsibilities of mid-level army leadership _and_ management. -- (This man's opinions are his own.) From mole-end Mark Terribile mat@mole-end.matawan.nj.us, Somewhere in Matawan, NJ (Training and consulting in C, C++, UNIX, etc.)