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,FREEMAIL_FROM autolearn=unavailable autolearn_force=no version=3.4.4 X-Received: by 2002:a5d:9f4a:: with SMTP id u10mr4386580iot.243.1560271591079; Tue, 11 Jun 2019 09:46:31 -0700 (PDT) X-Received: by 2002:a05:6830:1697:: with SMTP id k23mr2402417otr.16.1560271590957; Tue, 11 Jun 2019 09:46:30 -0700 (PDT) Path: eternal-september.org!reader01.eternal-september.org!feeder.eternal-september.org!weretis.net!feeder6.news.weretis.net!feeder.usenetexpress.com!feeder-in1.iad1.usenetexpress.com!border1.nntp.dca1.giganews.com!nntp.giganews.com!s188no208266itb.0!news-out.google.com!l135ni407itc.0!nntp.google.com!s188no208265itb.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail Newsgroups: comp.lang.ada Date: Tue, 11 Jun 2019 09:46:30 -0700 (PDT) In-Reply-To: <0c9a9692-5fa2-46ba-8649-d5bddcc88a3f@googlegroups.com> Complaints-To: groups-abuse@google.com Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=146.5.2.29; posting-account=lJ3JNwoAAAAQfH3VV9vttJLkThaxtTfC NNTP-Posting-Host: 146.5.2.29 References: <28facad3-c55f-4ef2-8ef8-004925b7d1f1@googlegroups.com> <87woi0xtwm.fsf@nightsong.com> <4a0438de-1f1d-4469-aae4-908854d378ea@googlegroups.com> <47d02bdc-6b50-43aa-bc5d-bb5b6225f5bd@googlegroups.com> <4516d350-0076-4dc7-b482-87d5693d3977@googlegroups.com> <0c9a9692-5fa2-46ba-8649-d5bddcc88a3f@googlegroups.com> User-Agent: G2/1.0 MIME-Version: 1.0 Message-ID: Subject: Re: Why .ads as well as .adb? From: Shark8 Injection-Date: Tue, 11 Jun 2019 16:46:31 +0000 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Xref: reader01.eternal-september.org comp.lang.ada:56618 Date: 2019-06-11T09:46:30-07:00 List-Id: On Tuesday, June 11, 2019 at 10:14:33 AM UTC-6, John Perry wrote: > On Tuesday, June 11, 2019 at 10:39:21 AM UTC-5, Brad Moore wrote: > > Consider a java class from an example of the n-body problem from the Co= mputer Benchmarks Game website; > >=20 > > See https://benchmarksgame-team.pages.debian.net/benchmarksgame/program= /nbody-java-5.html > >=20 > > For the comparison, examine the NBodySystem class, which is the bulk of= the example, which appears to be a well written java program. > >=20 > > Imagine someone handed you this class and you asked you to write a prog= ram that uses it. It takes a bit of reading to pull out the important parts= , just to figure out how to use the class. >=20 > Why would someone hand you the source code? It's more likely they would h= and you the output from javadoc, and you'd work with that. (a) Have you ever been employed in a small / medium software shop? In my ex= perience its almost *always* that you "get handed the source code". (b) You're assuming there is documentation, and that it is some level of qu= ality that makes it usable/readable. (c) Javadoc is *NOT* inherently usable/readable =E2=80=94 Aside from things= like "Parameter X is an integer" (Yes, I can see that!) There tends to be = a bit of laziness WRT such suto-generated systems =E2=80=94 see the comment= upthread about "screenshots of the UI" and "'to frobnicate the lesneric, p= ress the button' -- without any coherent descript= ion of 'frobnication' or 'lesnerics'."