Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Jonathan Corbet <corbet@lwn.net>
To:     Costa Shulyupin <costa.shul@redhat.com>
Cc:     "open list:DOCUMENTATION" <linux-doc@vger.kernel.org>,
        open list <linux-kernel@vger.kernel.org>
Subject: Re: [PATCH] docs: remove tree links from the main index
In-Reply-To: <CADDUTFxu4owj_aXo2OBug3qBLbmS8boNXzcra8qLsqDYwN5Kpg@mail.gmail.com>
References: <20230718185156.1015753-1-costa.shul@redhat.com>
 <87y1j9ca42.fsf@meer.lwn.net>
 <CADDUTFxu4owj_aXo2OBug3qBLbmS8boNXzcra8qLsqDYwN5Kpg@mail.gmail.com>
Date:   Mon, 24 Jul 2023 10:19:56 -0600
Message-ID: <87mszlb7tf.fsf@meer.lwn.net>
MIME-Version: 1.0
Content-Type: text/plain
Precedence: bulk

Costa Shulyupin <costa.shul@redhat.com> writes:

> The left column "Contents" is overloaded and hard to use. The value of
> this patch is to make it more usable.
>
> Sections of the main page are not displayed after patch "docs: Add
> more information to the HTML sidebar". So sections don't work now and
> should be fixed too.
>
> I have in mind to reorganize the main page so the left column
> "Contents" becomes usable.

No, that is not the right approach.

Much of our documentation is just thrown together in haphazard ways, but
the front page has actually been the target of a certain amount of
thought.  It is, after all, the entry point into our documentation.

This page can surely be improved.  But thrashing it up for the purpose
of making the sidebar better is getting the priorities wrong; the front
page is far more important.  The way to improve the sidebar is to change
how that is generated; that almost certainly requires digging into the
theme code.  That has been on my list for some time, but I haven't
gotten to it.  It would be wonderful if somebody beat me to it.

Thanks,

jon