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.3 required=5.0 tests=BAYES_00,INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: fac41,af40e09e753872c X-Google-Attributes: gidfac41,public X-Google-Thread: 1014db,30e368bdb3310fe5 X-Google-Attributes: gid1014db,public X-Google-Thread: f8c65,30e368bdb3310fe5 X-Google-Attributes: gidf8c65,public X-Google-Thread: 109fba,f292779560fb8442 X-Google-Attributes: gid109fba,public X-Google-Thread: 10db24,30e368bdb3310fe5 X-Google-Attributes: gid10db24,public X-Google-Thread: 103376,30e368bdb3310fe5 X-Google-Attributes: gid103376,public X-Google-Thread: 1008e3,30e368bdb3310fe5 X-Google-Attributes: gid1008e3,public From: kcline@sun132.spd.dsccc.com (Kevin Cline) Subject: Re: The Last Word on Comments (was Re: Hungarian notation) Date: 1996/06/13 Message-ID: <4pprl5$8nf@tpd.dsccc.com>#1/1 X-Deja-AN: 160044144 references: <4o07o9$rfu@seagoon.newcastle.edu.au> <31BDA39F.14E4@phidani.be> <4pkkr6$t31@michp1.redstone.army.mil> organization: DSC Communications Corporation Switch Products Division newsgroups: comp.lang.ada,comp.lang.c++,comp.lang.c,comp.lang.modula3,comp.lang.modula2,comp.edu,comp.lang.eiffel Date: 1996-06-13T00:00:00+00:00 List-Id: In article <4pkkr6$t31@michp1.redstone.army.mil>, Kevin J. Weise wrote: >Darius Blasbans wrote (with deletions): >>Clark L. Coleman wrote: >>>I shudder to think that >>> someone is paying them to develop code if they really think you add >>> comments after the code is written. >> > >If you think this practice is bad, wait until you hear/read this: >I worked for a company several years ago where part of the development >environment was a PDL generator. You got it! > They developed the code first, then ran it through a program to > produce the PDL to put in the design document!! And they believed > it was a perfectly reasonable way to do things!! > >I can understand desiring to reduce the documentation effort, but to go >from B-specs to code using an undocumented process that back-filled the >design? I can't wait to see responses to this one. These practices are typically a response to documentation requirements that result when the 2167A standard is not properly tailored. This can happen because the contractor doesn't know how to demonstrate that efficient development practices are 2167A compliant, or because the contracting officer doesn't understaind 2167A tailoring and covers his ass by requiring every item of every DID in the document. Probably most of the verbage in the design documentats was useless for any practical purpose, but supplied for some 2167A requirement. The developers thought that writing PDL before coding was a waste of time. They were right. For many projects, experienced developers can proceed directly from OO design to API definitions (e.g. C++ class definitions or Ada module specifications) and then to implementation. Only DoD contractors working on cost-plus contracts have time to write PDL, or even worry about it at all. -- Kevin Cline