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.1 required=5.0 tests=BAYES_05,INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: f43e6,8ff817fc5c863f82 X-Google-Attributes: gidf43e6,public X-Google-Thread: 1014db,d95b511473b3a931 X-Google-Attributes: gid1014db,public X-Google-Thread: 109fba,d95b511473b3a931 X-Google-Attributes: gid109fba,public X-Google-Thread: 103376,d95b511473b3a931 X-Google-Attributes: gid103376,public From: John Byerly Subject: Re: software engineering and the notion of authorship Date: 1996/07/08 Message-ID: <31E19744.5CA3@dalmatian.com>#1/1 X-Deja-AN: 167283954 sender: news@schbbs.mot.com (SCHBBS News Account) references: <4quk22$78@krusty.irvine.com> <4r059t$2at0@info4.rus.uni-stuttgart.de> <4r3bp1$cea@Starbase.NeoSoft.COM> <4rg3ph$2on4@info4.rus.uni-stuttgart.de> <4rjhv6$ilu@mulga.cs.mu.OZ.AU> <31E0CF36.FDC@tick.infomatik.uni-stuttgart.de> content-type: text/plain; charset=us-ascii organization: The Dalmatian Group, Inc. mime-version: 1.0 newsgroups: comp.lang.ada,comp.lang.c,comp.lang.c++,comp.software-eng x-mailer: Mozilla 2.0 (X11; I; SunOS 5.4 sun4m) Date: 1996-07-08T00:00:00+00:00 List-Id: Jakob Engblom wrote: > > Yeah, but the real problem comes 10 years down the road, when the experts > have quit or died or moved to other projects and plain do not remember the > wonderfully complicated code they created back in '96... That's why we document code. Software engineering is the only engineering discipline that considers documentation to be optional. And even when documents are produced, they are almost never updated after the code is written. Speaking as someone who always seems to get stuck maintaining code, I find that something as simple as comments go a long way toward making my job easier. > Using a "just complicated enough to do the job", "ego-less" programming style, > makes it much easier for the new maintenance developer working with the > program in 2006... the savings in the long run far outweigh the lack of > "personal style" in the code. I disagree. I started my software engineering career maintaining undocumented FORTRAN code that was about as ego-less as you get and the thing was a nightmare. More recently, I have maintained well commented, C++ code that was created using a style that was unfamiliar. This experience was much less painful. > Only in software do we even think of accepting personal style like... it would > be quite devastating in any other industry if an engineer insisted on using > left-handed instead of right-handed bolts "because I feel creative today".. That is why this is called _soft_ware. To a certain extent, we have more flexibility in creating our product than, say, a mechanical engineer. In a strict sense, however, our deliverables are object files, libraries, executables, etc., which had better match the specifications. This is the "right-handed bolt". > things have to fit together, . . . Quite true. That is what an Interface Specification is for. __________________________________________________________________________ John A. Byerly Which way to Flower Mound, TX? The Dalmatian Group, Inc. User Interface Specialists Currently on site at: jbyerly@dalmatian.com Motorola -- Chandler, AZ