Re: [PATCH v3] Documentation: cgroup-v2: Replace manual table of contents with contents:: directive
From: Tejun Heo
Date: Thu Sep 18 2025 - 11:44:58 EST
Hello,
On Thu, Sep 18, 2025 at 02:40:49PM +0700, Bagas Sanjaya wrote:
> cgroup v2 docs is a lengthy single docs, as compared to cgroup v1 which
> is split into several reST files. Meanwhile, its manually-arranged table
> of contents can get (and indeed) out-of-sync with actual contents when
> new sections forget to be added to it.
>
> Replace it with automatically-generated table of contents via contents::
> directive.
>
> Signed-off-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx>
I don't think I'm going to apply this. Sure, it can get out of sync but I'd
rather have TOC which sometimes is a bit out of sync than none at all.
Thanks.
--
tejun