Re: [PATCH v2 0/3] docs: some automarkup improvements

["Nícolas F. R. A. Prado" <nfraprado@collabora.com>]

On Thu, 2025-06-05 at 10:32 -0600, Jonathan Corbet wrote:
> Nícolas F. R. A. Prado <nfraprado@collabora.com> writes:
> 
> > The only other thing I noticed is that the links in the sidebar
> > still use the
> > old style, since they rely on a different CSS selector for some
> > reason:
> > 
> >   div.sphinxsidebar a {
> >     text-decoration: none;
> >     border-bottom: 1px dotted #999;
> >   }
> > 
> > That makes it a bit inconsistent style-wise, so I think it'd be
> > sensible to
> > update that selector as well to follow suit.
> 
> Sigh.  Of course, making it exactly the same doesn't work well due to
> the shading that we already use in the sidebar.  Since we know
> everything in the sidebar is a link, I suggest something like this:
> 
>     a.sphinxsidebar a { border-bottom: none; }
>     a.sphinxsidebar a:hover {
>     	border-bottom: none;
>         text-decoration: underline;
>         text-underline-offset: 0.3em;
>     }
> 
> That makes the sidebar relatively uncluttered, but still lights up
> the
> links in a visible way when the pointer passes over them.

Personally I'm fine with either approach. Just note that there's a typo
there, should be div. not a.:

   div.sphinxsidebar a { border-bottom: none; }
   div.sphinxsidebar a:hover {
       border-bottom: none;
       text-decoration: underline;
       text-underline-offset: 0.3em;
   }

-- 
Thanks,
Nícolas