Subject: Re: NetBSD Documentation Framework - how to do it
To: None <netbsd-docs@netbsd.org>
From: James K. Lowden <jklowden@schemamania.org>
List: netbsd-docs
Date: 12/14/2006 08:33:18
Mike M. Volokhov wrote:
> "James K. Lowden" <jklowden@schemamania.org> wrote:
> > Mike M. Volokhov wrote:
> > > This can (and is) done in the following forms:
> > > 
> > > 	- web-site
> > > 	- documents for offline browsing
> > > 	- documents for printing (including books)
> > > 	- other forms (not addressed here): verbal, prezos, ads...
> > > 
> > > Can you use Jade as solution for the first three? Yes, but it has
> > > not been adopted for this yet. 
> > 
> > I'm not sure what you mean by "it has not been adopted for this yet." 

I wasn't trying to be combative, Mishka.  I was hoping you would explain
what you meant by "not adopted". 

> Please compare the following two guides:
> 
> 	- http://www.ua.netbsd.org/guide/download/netbsd-en.pdf.gz
> 	- http://www.oreilly.com/catalog/bsdhks/chapter/hack67.pdf

Done. I think your point is that Dru's book is more visually attractive? 
And that you would like to see us using a toolchain that produced
similarly attractive works?  And you doubt DocBook is the answer?  

Using one source document to produce a website and a book requires
compromises.  If your goal is "most attractive", you have to be willing to
use two sources.  If your goal is "more attractive than today", you could
stick with DocBook and tailor it both with stylesheets and some
output-specific sections.  

--jkl