Akira Yokosawa <akiyks@xxxxxxxxx> 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
