]> www.infradead.org Git - users/jedix/linux-maple.git/commit
Docs/mm/index: rename 'Legacy Documentation' to 'Unsorted Documentation'
authorSeongJae Park <sj@kernel.org>
Mon, 1 Jul 2024 19:05:11 +0000 (12:05 -0700)
committerJonathan Corbet <corbet@lwn.net>
Wed, 3 Jul 2024 22:19:15 +0000 (16:19 -0600)
commit9472274c923389bbcdbfd1b1e394b638d37b4b0a
tree5939c29459b8111a9cd8cbe37ffacc195f78c159
parent8c678c9ca7cefff42130ec4a7531e2b7660e41b0
Docs/mm/index: rename 'Legacy Documentation' to 'Unsorted Documentation'

The intention of 'Legacy Documentation' chapter is to keep the old
documents that not yet sorted into the new outline, and encourage new
documents to be integrated in the new outline from the beginning.

However, the new outline will take some more time to be completed.  It
has started about two years ago, and still many parts are not yet
written.  Also, there is no clear guidline for placing each document for
all cases, for not only the 'legacy' documents, but also for new
documents.  For example, memory allocation profiling document has been
added to the bottom of the new outline.  Apparently it was not following
some well-defined guideliens or a result of a discussion.

Furthermore, the title ("legacy") makes people feel the documents on the
chapter might be outdated or not actively maintained.

Rename 'Legacy Documentation' to 'Unsorted Documentation' and remove the
description saying it is for 'older' documents.  After this change, new
documents that not clear enough where it should be placed on the new
outline can be added on the chapter while well-defined guidelines or
discussion for the new outline is made.

Signed-off-by: SeongJae Park <sj@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240701190512.49379-4-sj@kernel.org
Documentation/mm/index.rst