Re: [jamboost] Re: V2 documentation format: a resolution?

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-02-10 02:54:14

Zbynek Winkler wrote:

> > I personally like seeing the whole ToC, because I rarely read
> > top-to-bottom but instead like to pick one small section to read at a
> > particular time.
>
> I am not suggesting dropping the toc altogether. I am just saying that IMHO
> it is not a good title page (index.html). There is no reason why there
> couldn't be a separate toc page.

While TOC on the first page is not so bad in my opinion, if we could place
"how to use this document" section there it would be even better. 

TOC can then follow it. We can even decrease the nesting of main TOC with

<xsl:param>toc.section.depth=1

and restructure docs a bit.

Alas, I have no idea how to put anything before doc. I keep on reading Docbook 
faq.

- Volodya