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@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