Re: New theme - Alabaster for Kernel Documentation

[Jonathan Corbet <corbet@lwn.net>]

Konstantin Ryabitsev <konstantin@linuxfoundation.org> writes:

> On Thu, Jan 19, 2023 at 02:29:21PM -0700, Jonathan Corbet wrote:
>> Akira Yokosawa <akiyks@gmail.com> writes:
>> 
>> > Konstantin, would it be possible for you to add "DOCS_THEME=sphinx_rtd_theme"
>> > for the "latest" kernel documentation builds until the new default theme
>> > becomes good enough for most people?  That is if Jon agrees.
>> > For the "next" builds, alabaster theme should be OK, and easier for us to
>> > compare the two themes.
>> 
>> I'd prefer to avoid this if possible.  In the end, though, what
>> kernel.org does isn't my decision, of course...
>
> Something I've considered is to have /latest/ show the latest mainline
> *released* mainline, while /rc/ would show the latest rc. So, we'd have three
> distinct movable targets:
>
> docs.kernel.org       - latest mainline release (same as kernel.org/doc/html/latest/)
> docs.kernel.org/next/ - linux-next
> docs.kernel.org/rc/   - latest rc
>
> Would that be acceptable as a solution?

I think we've miscommunicated somewhere.  What I don't like is the idea
of building the mainline docs with a non-default HTML theme.

A "latest -rc" build could be a nice thing, though :)

Thanks,

jon