Hi, Jim,
Jim C. Nasby wrote:
> An issue I've seen with the docs is that for chapters that have a lot of
> sections (such as 8), the section list at the start of each chapter
> fills the screen, so it's easy to miss the fact that there's more info
> beneath the list (which is wy presumably most folks never knew that
> table existed).
>
> I think the ideal way to handle this would be to put the table of
> contents in a side-bar and flow the text around it. But that could be a
> real bear to do in docbook/sgml, so perhaps it would be better to just
> force the TOC for each chapter onto it's own page (and ensure the
> overview/introduction text shows up in the TOC).
I agree.
The fact that the TOC and the first part of the Chapter are on the same
page has annoyed me several times now. :-)
Regards,
Markus
--
Markus Schaber | Logical Tracking&Tracing International AG
Dipl. Inf. | Software Development GIS
Fight against software patents in Europe! www.ffii.org
www.nosoftwarepatents.org