Re: [PATCH RFC 0/5] docs: Improvements to our HTML output

From: Jonathan Corbet
Date: Thu Oct 06 2022 - 09:49:32 EST


Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> writes:

> I admit my wish-list replies to this thread may seem a bit obnoxious,
> when I'm not prepared to contribute. Sorry about that. My intention was
> not to block any of this, rather muse about what the future direction
> might be.

Wish lists are good. As noted before, if we're depending on me to come
up with the web design, we're in trouble...

> Overall I think this is an improvement.
>
> There's only two things that I'd like to get addressed, not necessarily
> now, but eventually:
>
> - As mentioned, the main div width as pixels in the alabaster
> theme. It's really crappy on wide 4K displays. Only a quarter of the
> full screen width is used.
>
> - The function/struct/etc. main descriptions are now displayed in the
> gray background, along with the "declaration", instead of white
> background. Is that an intenational alabaster feature, or is it
> something we do to cause that? Seems like the description gets a bit
> hidden there.

Both of these should be relatively easily done with CSS overrides, I'll
look into it.

jon