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

[Jonathan Corbet <corbet@lwn.net>]

Akira Yokosawa <akiyks@gmail.com> writes:

> I think the patch appended below (on top of current docs-next)
> would have been a better approach, where each .rst file is listed
> only once in the whole toctree. The refurbished part of main index
> is moved to index-frequent.rst and toctrees are replaced with
> lists of :doc: references.
>
> Per-directory indexes are listed in the main index's toctree
> below the index-frequent.
>
> I'm not saying this is "the" right approach.
> There can be many ways to accomplish the same result, I suppose.
>
> I'll submit this change as a proper patch if I can get positive
> feedback.

So I applied this and built it.  There may be potential in this
approach, but I don't think we are there yet.

This change completely loses the organization that I wanted to put onto
the front page itself.  That page will be the place where people land
first, so it should guide them to somewhere useful as quickly and easily
as possible.  With this change, we've hidden that guidance in a
subsidiary page and the front is back to a random collection of
unordered stuff.

The front page, I think, is more important than the sidebar.

We really need to look into the actual generation of the sidebar; it's
on my list, but won't happen before the merge window.  I do appreciate
playing with ideas, though - please keep it up!  We'll figure out
something eventually...:)

Thanks,

jon