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-Thread: 103376,deac256a05c84a59 X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news1.google.com!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail From: Nick Roberts Newsgroups: comp.lang.ada Subject: Re: DOM and SAX parsing in Ada Date: Thu, 27 Jan 2005 20:05:34 +0000 Message-ID: References: <41900010.D28DD400@boeing.com> <9CWjd.17305$5K2.1356@attbi_s03> <1106223415.857525.176640@c13g2000cwb.googlegroups.com> <41F4DB6F.4090909@mailinator.com> <35nh12F4oe4caU1@individual.net> Content-Type: text/plain; charset=us-ascii X-Trace: individual.net 0PO0Sz2FefqB7Tc7fTyjngKI/mf7lvJbYEkXNjonJHcICrLDU= X-Orig-Path: not-for-mail User-Agent: Gemini/1.45d (Qt/3.3.2) (Windows-XP) Xref: g2news1.google.com comp.lang.ada:8022 Date: 2005-01-27T20:05:34+00:00 List-Id: Stephen Leake wrote: > > So, I could see very little advantage to making any contributions to > > XML/Ada, since it would create two XML/Adas (mine and AdaCore's). Would > > that be an advantage to the Ada community? > > Big disconnect. Why do you say there would be two? Hmm, apparently you > feel you can only contribute if the CVS repository is on SourceForge. Why > is that, specifically? I told the AdaCore employee that I wanted to make a large number of small changes (a lot of comments that would help identify fragments of code, for referential maintenance documentation), and he responded that he felt such changes were not necessary. I took this to imply (although admittedly he didn't say so explicitly) that he wouldn't accept these changes into the AdaCore CVS repository. On this basis, I was assuming that I would have to create a forked project on some other repository (of course it doesn't have to be SourceForge per se). > > On the subject of comments, I suggested that the amount of maintenance > > documention (in the form of comments or in any other form) was > > insufficient -- it was nearly nonexistent, in fact -- and the answer > > was, in essence, that no maintenance documentation is required, since > > the code is self-documenting. I'm afraid, to me, that attitude is > > unacceptable (and doesn't seem very professional, frankly). > > Well, did you try reading the code? THat is the only thing that matters, > not some arbitrary standard of "not enough comment lines". If you can, in > fact, understand it, then it _is_ self-documenting. Of course I read the code, Stephen! In the package bodies there are almost no comments at all, and there is no other maintenance documentation. The code is very complex, and no vaguely self-documenting. The idea that it could be struck me (and still strikes me) as, frankly, bizarre. > On the other hand, I agree that a lot of AdaCore's code is not well enough > documented; I'm thinking of some parts of GtkAda in particular. Well, that would seem to be a case in point, then. > But the proper response is to contribute good documentation, not just > complain. I wanted to do precisely that! I specifically offered to contribute maintenance documentation, but this offer seemed to be rejected, in effect, by the AdaCore employee I communicated with. -- Nick Roberts