Re: [PATCH RFC] sphinx-static/theme_overrides.css: switch to a fixed width documentation

["Antonin Godard" <antonin.godard@bootlin.com>]

On Mon Feb 2, 2026 at 11:47 AM CET, Antonin Godard wrote:
> Change the css rules of our theme to have a fixed-width documentation
> instead of it taking the full width of the page. I believe this makes it
> much more readable compared to having long lines with few line returns,
> especially on high-resolution displays. Set the width to 1000px instead
> of the previous 800px, which felt slightly too thin.
>
> I think the removed comment here does not make that much sense for us.
> It was added by commit 0c1e108bc6c4 ("sphinx: add CSS theme override"),
> and I believe is a simply copy and paste of what was is set in the Linux
> kernel, added by commit 9abaf979abb2 ("doc-rst: customize RTD theme,
> table & full width") [1].
>
> [1]: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=9abaf979abb2

A preview of this patch can be seen at
https://docs.yoctoproject.org/next/index.html.

Any feedback appreciated! I think the docs are more readable like this.

The only drawbacks I would see are:

- Large tables are a bit less readable (but we only have a few: in the release
  notes and on the list of supported features, IIRC).

- Detailed images are not as readable (but can be clicked to be seen fully).

Thanks,
Antonin