[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <a0e8aba6-b28f-c460-9bab-5695000727fb@infradead.org>
Date: Thu, 22 Jun 2023 08:35:06 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Costa Shulyupin <costa.shul@...hat.com>,
Jonathan Corbet <corbet@....net>, linux-doc@...r.kernel.org
Cc: open list <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH] docs: consolidate core subsystems
Hi--
On 6/22/23 00:10, Costa Shulyupin wrote:
> to make the page more organized as requested
>
> Signed-off-by: Costa Shulyupin <costa.shul@...hat.com>
> ---
> Documentation/subsystem-apis.rst | 21 ++++++++++++++-------
> 1 file changed, 14 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/subsystem-apis.rst b/Documentation/subsystem-apis.rst
> index b67a1b65855b..8664b05777c3 100644
> --- a/Documentation/subsystem-apis.rst
> +++ b/Documentation/subsystem-apis.rst
> @@ -10,6 +10,20 @@ is taken directly from the kernel source, with supplemental material added
> as needed (or at least as we managed to add it — probably *not* all that is
> needed).
>
> +Core subsystems
> +---------------
> +
> +.. toctree::
> + :maxdepth: 1
> +
> + core-api/index
> + driver-api/index
> + mm/index
> + power/index
> + scheduler/index
> + timers/index
> + locking/index
> +
In general I am OK with this grouping, except for 2 nits:
a. I'm not sure that locking is a subsystem (it's a core API IMO).
b. I often have trouble finding "filesystems" and I think that it should be
given a higher location in the TOC (somehow).
thanks.
--
~Randy
Powered by blists - more mailing lists