RE: DSSSL Documentation Project

Subject: RE: DSSSL Documentation Project
From: "Pawson, David" <DPawson@xxxxxxxxxxx>
Date: Wed, 21 Jan 1998 08:12:49 -0000

> 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.
> 	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
	[Pawson, David]  Agree with Ben that a longer term goal should
	a comprehensive whole.  Also that many parts are needed to fully
	comprehend the whole. Pauls tutorial I found largely
'stand-alone', so
	eurely we are simply debating how to get to the greater part?

	other concerns centre on the longevity / stability of DSSSL. A '
bit part '
	approach would be easier to get under way   and 
	a different use of glue would permit a rebuild to account for
	  Must go with Paul, on the grounds that your aims can be met
	using Pauls suggestion - links the parts on site (ease of
build), then
	look at integration as a worthwhile activity later on.

	A further implication is the use of html rather than docbook.
	Simpler, easier (for most) and quicker. If this team can't do a
bit of 
	re-formatting later, then who can!  
	the trick as I see it is to get the foundations in place to
permit a wider
	understanding for the newcomer, permitting him/her to use later
	What do we _need_ to understand (other than the jargon) prior to
	on to 'bulking up' on knowledge.
	Perhaps basic terminology put in some simple context,
	A rudimentary grasp of Scheme syntax
	The baseline ideas of sosofo's (thanx James, accurate but .....
	The concept of a document as tree, then off into building.


 DSSSList info and archive:

Current Thread
  • Re: DSSSL Documentation Project, (continued)
      • Tony Graham - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id WAA21409Mon, 19 Jan 1998 22:16:24 -0500 (EST)
        • Ben Trafford - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id WAA21586Mon, 19 Jan 1998 22:25:49 -0500 (EST)
    • Pawson, David - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id EAA04071Tue, 20 Jan 1998 04:26:37 -0500 (EST)
    • Steve Roggenkamp - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id NAA08430Tue, 20 Jan 1998 13:25:41 -0500 (EST)
    • Pawson, David - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id DAA22087Wed, 21 Jan 1998 03:15:28 -0500 (EST) <=
      • Paul Prescod - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id IAA24338Wed, 21 Jan 1998 08:48:18 -0500 (EST)
        • Tony Graham - from mail1.ability.netby (8.8.5/8.6.12) with ESMTP id NAA26511Wed, 21 Jan 1998 13:48:38 -0500 (EST)