Re: [PATCH v2 2/4] Documentation: cgroup-v2: Add section numbers

[Michal Koutný]

On Mon, Sep 15, 2025 at 07:40:29PM +0700, Bagas Sanjaya <bagasdotme@xxxxxxxxx> wrote:
> > Erm, so in addition to keeping manual ToC in sync, we'd also need to
> > maintain the section numbers manually?
> 
> Right.

I mean -- that's not right. Either generate all automatically (original
approach) or simplify maintenance of the manual ToC (as liked by Tejun)
by stripping (meaningless?) manual numbers.

> > What about dropping the numbers from manual ToC and sections? (If manual
> > ToC is to be preserved.)
> 
> Nope. To be fair, we also want section numbers for htmldocs readers, though.

That'd be better automatic too
https://docutils.sourceforge.io/docs/ref/rst/directives.html#automatic-section-numbering

Thanks that you look into this!
Michal

Attachment: signature.asc
Description: PGP signature