Re: [PATCH RFC V2] docs: Add more information to the HTML sidebar

[Jonathan Corbet <corbet@lwn.net>]

Randy Dunlap <rdunlap@infradead.org> writes:

> Is there a reason that the main index's "sections" (single underline)
> don't show up in the sidebar index?  Is that on purpose?
> Or just a relic of them being "sections"?

That's just how the sidebar gets generated.  I would much rather see the
sections there...but if we want that, I think we'll have to implement it
ourselves.

> (Why are they sections? Why is the main document's title a chapter
> instead of being the Document title?)

Good question...that's just how it was done.  Probably worth fixing.

> I would like to be able to see visually when the sidebar index goes from
> one "section" to another one, e.g., from "Internal API manuals"
> to "Development tools and processes". I think that there might be a
> small blank (like 1/2 line space) between these sections now, but
> that is easy to overlook.

See above :)

Thanks,

jon