[Bug web/107650] Sphinx generated web pages don't have "up" (to the section TOC)

["pinskia at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=107650

--- Comment #4 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
(In reply to Martin Liška from comment #3)
> (In reply to Andrew Pinski from comment #0)
> > The texinfo generated HTML has an up link which links to the section that
> > the page is linked from.
> > While the Sphinx generated HTML does not.
> > An example for texinfo is
> > https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/eBPF-Options.html#eBPF-Options
> > compared to
> > https://gcc.gnu.org/onlinedocs/gcc/gcc-command-options/machine-dependent-
> > options/ebpf-options.html .
> > 
> > Is there a way to get this feature back? as it is useful when browsing the
> > manual.
> 
> No, I don't think it was useful as one was missing complete navigation that
> is right now on the left.

Except the navigation does not fully replace the up button.
An example is if you scroll down on the top level TOC down to the "Nios II
Options" (not on the navigation on the left) and click it. The navigation on
the left does not scroll down to the same location. Making it harder to figure
out where you are.

> 
> > 
> > The other thing that would be a nice feature back is having next/previous/up
> > links at the start also and not just at the end of the page.
> > 
> > The order of previous and next on the bottom of the page is ok even though
> > it is swapped from what it was previously.
> 
> The layout is better in Sphinx as it corresponds to expect layout (similarly
> to web browsers).

So that is broken. Having it on the top and the bottom is still useful. Maybe
you clicked the wrong link but it was the next one you either have to use the
left/right links at the buttom or you have to understand the left/right curser
keys are bound to previous/next page. Again still confusing. Most web UI
designers have ignored UI design for years how humans work and just make broken
things we should not repeat the same mistakes.