Re: Why .ads as well as .adb?

[Shark8 <onewingedshark@gmail.com>]

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 Computer Benchmarks Game website;
> > 
> > See https://benchmarksgame-team.pages.debian.net/benchmarksgame/program/nbody-java-5.html
> > 
> > For the comparison, examine the NBodySystem class, which is the bulk of the example, which appears to be a well written java program.
> > 
> > Imagine someone handed you this class and you asked you to write a program that uses it. It takes a bit of reading to pull out the important parts, just to figure out how to use the class.
> 
> Why would someone hand you the source code? It's more likely they would hand 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 experience its almost *always* that you "get handed the source code".
(b) You're assuming there is documentation, and that it is some level of quality that makes it usable/readable.
(c) Javadoc is *NOT* inherently usable/readable — 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 — see the comment upthread about "screenshots of the UI" and "'to frobnicate the lesneric, press the <Frobnicate the Lesneric> button' -- without any coherent description of 'frobnication' or 'lesnerics'."