Re: [PATCH v5] Documentation/mm: Initial page table documentation

[Jonathan Corbet <corbet@lwn.net>]

"Fabio M. De Francesco" <fmdefrancesco@gmail.com> writes:

> I question the target audience of this documentation. How can we expect any 
> developer working with Linux to be unaware of such basic concepts? Adding 
> documentation about these foundational concepts would create a precedent, 
> potentially leading to further documentation on other fundamental abstractions 
> like "task," "multi-threading," and "scheduling" – concepts that are integral 
> to kernel management. The inclusion of such basic topics could quickly clutter 
> up the specialized Linux kernel documentation.

Someday, if we find ourselves in the position of having too much
documentation, we can entertain patches to clean out material that is
deemed to be too elementary for kernel developers.  Before then, though,
if we are worried about clutter, we may want to put more effort into
addressing the large amount of duplicated and obsolete documentation in
the kernel now.

Until then, I see no reason to oppose the addition of material that,
even if you don't personally find it helpful, may indeed be helpful to
developers trying to come up to speed on just what the kernel is doing.

Thanks,

jon