Re: [PATCH v3] Documentation: cgroup-v2: Replace manual table of contents with contents:: directive

From: Michal Koutný

Date: Thu Sep 18 2025 - 11:55:10 EST


On Thu, Sep 18, 2025 at 05:44:56AM -1000, Tejun Heo <tj@xxxxxxxxxx> wrote:
> 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.

The TOC is in the generated output :-p

I understand you want this "[PATCH v2 4/4] Documentation: cgroup-v2: Sync
manual toctree" [1], which is also fine.
But I'd drop this "[PATCH v2 2/4] Documentation: cgroup-v2: Add section
numbers" [2], because that adds more places for out-of-syncness.

Michal

[1] https://lore.kernel.org/lkml/20250915081942.25077-5-bagasdotme@xxxxxxxxx/
[2] https://lore.kernel.org/lkml/20250915081942.25077-3-bagasdotme@xxxxxxxxx/

Attachment: signature.asc
Description: PGP signature