[gambit-list] Truck-Factor by mtov
Hendrik Boom
hendrik at topoi.pooq.com
Fri Jul 24 15:48:57 EDT 2015
On Fri, Jul 24, 2015 at 07:14:47PM +0200, Álvaro Castro-Castilla wrote:
> On Fri, Jul 24, 2015 at 6:46 PM, Hendrik Boom <hendrik at topoi.pooq.com>
> wrote:
>
> > My example of exquisite documentation produced by a documentation generator
> > is the Trestle Reference Manual:
> >
> > http://www.std.org/~msm/common/SRC-RR-068.pdf
> >
> > If you look at the source code for Trestle, you'll find the source code
> > for the manual there, ofter interspersed in the interface files.
> > I'm sure that getting it to be coherent when extracted and displayed took
> > significant
> > effort in the design of the documentation generator and in the source code
> > of the
> > documented modules.
> >
> >
> Amazing.
Just to show what is really technically feasible.
We may have to settle for less, we may be used to making do with less,
but something like this is what to aim for.
-- hendrik
More information about the Gambit-list
mailing list