Re: DSSSL Documentation Project

[Ben Trafford <btrafford@xxxxxxxxxxxxxxxx>]

Paul Prescod wrote:

> Note that the Linux Documentation Project did not write a book. They
> essentially wrote many short tutorials and used hyperlinks and a central
> index to glue them together.

	Really? I didn't get that impression from the four main products of the
LDP; all of which are easily book-sized, and written by one person each.
The short tutorials from the LDP are something I've rarely used;
however, all four books ("Installation and Getting Started Guide", "The
Linux Kernel Hackers' Guide", "The Linux Kernel" and "The Linux Network
Administrators' Guide") are printed out and bound into binders for my
usage.

> I think that a more achievable goal would be to use the handbook outline
> as a list of documents we would like completed, as the Linux people do.
> We should then just link to the documents in the places where they
> currently live. For instance, the first half part one is essentially my
> tutorial (except I didn't write about the transformation language).

	Hrm. I have to confess that I'm not particularly keen on this idea,
mainly because so many parts of DSSSL are impossible to understand
without other parts. As long as we have a capable editor (and I think
Tony is more than capable), we should be able to fuse separate chapters
into a cohesive document.
	But that's just me. What do the rest of you think of Paul's idea?
 
--->Ben


 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist