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.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,8bc34e14e4555720 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2001-10-12 07:02:00 PST Sender: sjw@galadriel.frlngtn.gecm.com Newsgroups: comp.lang.ada Subject: Re: GRASP (was Re: This is a simple question) References: <9pk4t7$tbm$1@trog.dera.gov.uk> <87zo762rta.fsf@deneb.enyo.de> <9pkc0r$m5j$1@trog.dera.gov.uk> <9pkddm$afh$1@nh.pace.co.uk> <9pvdp5$8im$1@nh.pace.co.uk> <9pvk11$oke$1@news.huji.ac.il> <3BC35E72.BB1C3188@worldnet.att.net> <3BC647EE.69B94B34@worldnet.att.net> From: Simon Wright Date: 12 Oct 2001 14:54:09 +0100 Message-ID: Organization: Alenia Marconi Systems, ISD, Farlington X-Newsreader: Gnus v5.5/Emacs 20.3 NNTP-Posting-Host: galadriel.frlngtn.gecm.com X-Trace: 12 Oct 2001 14:50:54 GMT, galadriel.frlngtn.gecm.com Path: archiver1.google.com!news1.google.com!newsfeed.stanford.edu!newsfeeds.belnet.be!news.belnet.be!colt.net!easynet-quince!easynet-melon!easynet.net!btnet-feed5!btnet!newreader.ukcore.bt.net!pull.gecm.com!galadriel.frlngtn.gecm.com Xref: archiver1.google.com comp.lang.ada:14400 Date: 2001-10-12T14:54:09+01:00 List-Id: James Rogers writes: > This might have revealed a limitation of the process you used. I > have found it both reasonable and helpful to document all changes in > comments. Source code control systems may be able to identify many > changes. They cannot identify the reasons for the changes. The > changes should be a response to a documented requirement. Some of this is so right, and some of it is so wrong! One invaluable feature of a sccs (I use CVS) is that it can show you _exactly_ what changed. Only after that need you check up as to why. Suppose my potential coworker had accidentally changed a "+" to a "-" somewhere in a 200-line file that he'd completely reformatted. My chances of spotting that (his chances, come to that) would be close to zero. I completely agree that you need to document the reasons for change, in the VC log works for me. The concept of "documented requirement" seems just slightly foreign to that of "volunteer open-source project", though! -- Simon Wright Email: simon.j.wright@amsjv.com Alenia Marconi Systems Voice: +44(0)23 9270 1778 Integrated Systems Division FAX: +44(0)23 9270 1800