Re: [PATCH] mm,doc: Add new documentation structure

[Matthew Wilcox <willy@infradead.org>]

On Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote:
> > @@ -2,12 +2,32 @@
> >   Linux Memory Management Documentation
> >   =====================================
> > +This is a guide to understanding the memory management subsystem
> > +of Linux.  If you are looking for advice on simply allocating memory,
> > +see the :ref:`memory_allocation`.  For controlling and tuning guides,
> > +see the :doc:`admin guide <../admin-guide/mm/index>`.
> 
> This needs to be properly merged with the existing index. Otherwise
> the result here is very confusing because there are two summaries
> and no explanation of what is going on here.

Hm?  It reads OK to me the way I sent it out:

Linux Memory Management Documentation¶

This is a guide to understanding the memory management subsystem of
Linux. If you are looking for advice on simply allocating memory,
see the Memory Allocation Guide. For controlling and tuning guides,
see the admin guide.

[... list ...]

This is a collection of documents about the Linux memory management
(mm) subsystem internals with different level of details ranging from
notes and mailing list responses for elaborating descriptions of data
structures and algorithms.

[... another list ...]

> If I get a moment today, I'll take a quick shot at at merging them,
> and post some suggestions here, but just wanted to point that out
> before this goes in as-is.

Happy to sit down with you in a free moment.  I have all this on my
laptop, including an htmldocs built version.