Re: [PATCH RESEND 1/3] docs: cgroup: Explain reclaim protection target
From: Tejun Heo
Date: Fri Nov 14 2025 - 16:11:27 EST
On Fri, Nov 14, 2025 at 07:29:28PM +0100, Michal Koutný wrote:
> On Mon, Nov 10, 2025 at 01:00:41PM -0700, Jonathan Corbet <corbet@xxxxxxx> wrote:
> > > @@ -53,7 +53,8 @@ v1 is available under :ref:`Documentation/admin-guide/cgroup-v1/index.rst <cgrou
> > > 5-2. Memory
> > > 5-2-1. Memory Interface Files
> > > 5-2-2. Usage Guidelines
> > > - 5-2-3. Memory Ownership
> > > + 5-2-3. Reclaim Protection
> > > + 5-2-4. Memory Ownership
> >
> > I always have to ask...do we really need the manually maintained TOC
> > here?
>
> Tejun [1] (and maybe some others) like it.
I'm not married to it but I think a lot of people including me just read the
source docs without ever formatting them. It is kinda nice to have ToC for
them. Maybe section numbers are too error-prone, I don't know.
Thanks.
--
tejun