docs/144515: [handbook] Expand handbook Table of contents
Gabor Kovesdan
gabor at FreeBSD.org
Thu Jan 23 16:18:29 UTC 2014
On 2014.01.23. 16:59, Thomas Hoffmann wrote:
> I agree, the TOC is already too long vertically. Adding subsections
> would exacerbate the problem.
>
> By "horizontal page" I mean taking advantage of the full screen width,
> for example, by using multi-columns or similar technique. That would
> get more info on each screen page. Compare the TOC with the
> x-config.html page (
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html),
> which uses the full page width.
The problem with this is that TOC is a multiple level enumeration by
nature, which is conventionally listed vertically in order. Using two
columns may be confusing for people since it is not conventional. And if
we use 2 columns, what order would it follow? Like this:
1 2
1.1 2.1
1.2 2.2
1.3 2.3
Or this:
1
1.1 1.2
1.3 1.4
And what to do on smaller screens if the two columns do not fit?
I believe that a collapsible tree list would be the best option but that
requires JavaScript, which we prefer to avoid...
Gabor
More information about the freebsd-doc
mailing list