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=unavailable autolearn_force=no version=3.4.4 X-Received: by 2002:a24:f587:: with SMTP id k129mr21021592ith.77.1560277176289; Tue, 11 Jun 2019 11:19:36 -0700 (PDT) X-Received: by 2002:aca:5fd5:: with SMTP id t204mr15281449oib.0.1560277176043; Tue, 11 Jun 2019 11:19:36 -0700 (PDT) Path: eternal-september.org!reader01.eternal-september.org!feeder.eternal-september.org!news.gegeweb.eu!gegeweb.org!usenet-fr.net!proxad.net!feeder1-2.proxad.net!209.85.166.215.MISMATCH!s188no220629itb.0!news-out.google.com!l135ni463itc.0!nntp.google.com!s188no220628itb.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail Newsgroups: comp.lang.ada Date: Tue, 11 Jun 2019 11:19:35 -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=188.150.24.77; posting-account=HFCrOQoAAABZD_f-UUbYHm3lJDIrh-UX NNTP-Posting-Host: 188.150.24.77 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: <985a9791-0cec-442f-93eb-eeeae1eae1b6@googlegroups.com> Subject: Re: Why .ads as well as .adb? From: joakimds@kth.se Injection-Date: Tue, 11 Jun 2019 18:19:36 +0000 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Xref: reader01.eternal-september.org comp.lang.ada:56619 Date: 2019-06-11T11:19:35-07:00 List-Id: > 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. John, if that's your experience from industry then I am very happy for you.= I've worked for 12 years as software engineer since graduation from Univer= sity and my experience is that one simply gets handed the code with very li= ttle explanation and/or comments/documentation. The situation is often due = to stress, lack of time and requirements that has been changed during the l= ife-time of the code etc. When working with Java I often make use of "the Outline" in the IDE being u= sed in the project. It gives an overview of the Java code for example list = of functions and so on. Perhaps that would be a better example than the use= of JavaDoc in a Java project to get a high level view of the Java code. The arguments for and against having a separate spec. and body have been la= id bare in this discussion thread. Thanks to everybody for contributing to = it. Best regards, Joakim