NetBSD Documentation Framework - how to do it

"James K. Lowden" <jklowdenschemamania.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." 
> Jade obviously outputs HTML and PDF.  From my POV, that
satisfies the
> domain [1,3].  
> 
> If you mean "has not been adopted by the NetBSD
project", then, sure, of
> course.  

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


Next, please compare the following two web-site frameworks:

	- NetBSD DocBook Website based htdocs/share
	- Apache Forrest

And let me cite yourself: ``In order to accept this you
should
think about web-site as not about pile of [HTML] files
available
via HTTP, and about printable books as not about pile of
pages
which you can send to printer.''

Yes, there is a difference between web-site and pile of
files.
Someone can neglect this difference and call their pile as
"web-site".
But we usually referring the same thing as "bad
web-site". Even
worse for books.

--
Mishka.