Linux Documentation
 help / color / mirror / Atom feed
* [RFC PATCH 0/4] mm/damon: update documents for mm-next onboarding
@ 2026-11-21 19:33 SJ Park
  2026-11-21 19:33 ` [RFC PATCH 2/4] Docs/mm/damon/maintainer-profile: use damon.git for patch baselines SJ Park
                   ` (2 more replies)
  0 siblings, 3 replies; 4+ messages in thread
From: SJ Park @ 2026-11-21 19:33 UTC (permalink / raw)
  Cc: SJ Park, Andrew Morton, David Hildenbrand, Jonathan Corbet,
	Randy Dunlap, Shuah Khan, damon, linux-doc, linux-kernel,
	linux-mm

Right after the 7.5-rc1 release, DAMON will onboard the mm-next
transition [1].  The major change is that it will use mm/damon.git [2]
and mm/linux.git [3] instead of sj/linux.git [4] and akpm/mm.git [5].

Update MAINTAINERS file to capture the change, via patch 1.  Further
update DAMON maintainer-profile document for the change, step by step,
via patches 2-4.

[1] https://lore.kernel.org/bed81e01-7303-4957-bd7d-38e3a094e96f@kernel.org/
[2] https://git.kernel.org/pub/scm/linux/kernel/git/mm/damon.git/
[3] https://git.kernel.org/pub/scm/linux/kernel/git/mm/linux.git/
[4] https://git.kernel.org/pub/scm/linux/kernel/git/sj/linux.git/
[4] https://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm.git/

Huge thanks to Andrew for his tremendous mm.git works that raised DAMON
up to the current state.

SJ Park (4):
  MAINTAINERS: change DAMON SCM tree to mm/damon.git
  Docs/mm/damon/maintainer-profile: use damon.git for patch baselines
  Docs/mm/damon/maintainer-profile: drop 'SCM Trees' section
  Docs/mm/damon/maintainer-profile: update key cycle dates for damon.git

 Documentation/mm/damon/maintainer-profile.rst | 57 ++++++++++---------
 MAINTAINERS                                   | 36 ++++++------
 2 files changed, 46 insertions(+), 47 deletions(-)


base-commit: b0ddc1203e3d7a63e712e8988a03f98dbb179904
-- 
2.47.3

^ permalink raw reply	[flat|nested] 4+ messages in thread

* [RFC PATCH 2/4] Docs/mm/damon/maintainer-profile: use damon.git for patch baselines
  2026-11-21 19:33 [RFC PATCH 0/4] mm/damon: update documents for mm-next onboarding SJ Park
@ 2026-11-21 19:33 ` SJ Park
  2026-11-21 19:33 ` [RFC PATCH 3/4] Docs/mm/damon/maintainer-profile: drop 'SCM Trees' section SJ Park
  2026-11-21 19:33 ` [RFC PATCH 4/4] Docs/mm/damon/maintainer-profile: update key cycle dates for damon.git SJ Park
  2 siblings, 0 replies; 4+ messages in thread
From: SJ Park @ 2026-11-21 19:33 UTC (permalink / raw)
  Cc: SJ Park, Andrew Morton, David Hildenbrand, Jonathan Corbet,
	Randy Dunlap, Shuah Khan, damon, linux-doc, linux-mm

Right after 7.5-rc1, DAMON will onboard the mm-next transition [1].
Update DAMON maintainer-profile document to suggest using damon.git [2]
for-next and for-next-fixes trees as baselines, following the mm-next
process guideline.

[1] https://lore.kernel.org/bed81e01-7303-4957-bd7d-38e3a094e96f@kernel.org/
[2] https://git.kernel.org/pub/scm/linux/kernel/git/mm/damon.git/

Signed-off-by: SJ Park <sj@kernel.org>
---
 Documentation/mm/damon/maintainer-profile.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
index c482690320249..cc6b79c066a64 100644
--- a/Documentation/mm/damon/maintainer-profile.rst
+++ b/Documentation/mm/damon/maintainer-profile.rst
@@ -3,13 +3,20 @@
 DAMON Maintainer Entry Profile
 ==============================
 
-The DAMON subsystem covers the files that are listed in 'DAMON' section of
-'MAINTAINERS' file.
+The DAMON subsystem covers the files that are listed in 'MEMORY MANAGEMENT -
+DAMON' section of 'MAINTAINERS' file.
 
 The mailing lists for the subsystem are damon@lists.linux.dev and
-linux-mm@kvack.org.  Patches should be made against the `mm-new tree
-<https://git.kernel.org/akpm/mm/h/mm-new>`_ whenever possible and posted to the
-mailing lists.
+linux-mm@kvack.org.
+
+Non-urgent patches should be made against the damon.git `for-next
+<https://git.kernel.org/mm/damon/h/for-next>`_ tree.  Urgent patches should be
+made against the damon.git `for-next-fixes
+<https://git.kernel.org/mm/damon/h/for-next-fixes>`_ tree.  If there is a
+reason to not use those branches as the baseline of the patch, please explain
+the reason and what baseline is used.
+
+Patches should be posted to the mailing lists whenever possible.
 
 SCM Trees
 ---------
-- 
2.47.3

^ permalink raw reply related	[flat|nested] 4+ messages in thread

* [RFC PATCH 3/4] Docs/mm/damon/maintainer-profile: drop 'SCM Trees' section
  2026-11-21 19:33 [RFC PATCH 0/4] mm/damon: update documents for mm-next onboarding SJ Park
  2026-11-21 19:33 ` [RFC PATCH 2/4] Docs/mm/damon/maintainer-profile: use damon.git for patch baselines SJ Park
@ 2026-11-21 19:33 ` SJ Park
  2026-11-21 19:33 ` [RFC PATCH 4/4] Docs/mm/damon/maintainer-profile: update key cycle dates for damon.git SJ Park
  2 siblings, 0 replies; 4+ messages in thread
From: SJ Park @ 2026-11-21 19:33 UTC (permalink / raw)
  Cc: SJ Park, Andrew Morton, David Hildenbrand, Jonathan Corbet,
	Randy Dunlap, Shuah Khan, damon, linux-doc, linux-mm

Right after 7.5-rc1, DAMON will onboard the mm-next transition [1].  The
major change is that it will use damon.git [2] as its SCM tree.  'SCM
Trees' section on the maintainer profile document will be outdated.  The
updates for the new process would make the roles of the new trees clear.
Hence 'SCM Trees' section would be no more necessary.  Remove the
section.

[1] https://lore.kernel.org/bed81e01-7303-4957-bd7d-38e3a094e96f@kernel.org/
[2] https://git.kernel.org/pub/scm/linux/kernel/git/mm/damon.git/

Signed-off-by: SJ Park <sj@kernel.org>
---
 Documentation/mm/damon/maintainer-profile.rst | 20 -------------------
 1 file changed, 20 deletions(-)

diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
index cc6b79c066a64..f9a8df2b11e73 100644
--- a/Documentation/mm/damon/maintainer-profile.rst
+++ b/Documentation/mm/damon/maintainer-profile.rst
@@ -18,26 +18,6 @@ the reason and what baseline is used.
 
 Patches should be posted to the mailing lists whenever possible.
 
-SCM Trees
----------
-
-There are multiple Linux trees for DAMON development.  Patches under
-development or testing are queued in `damon/next
-<https://git.kernel.org/sj/h/damon/next>`_ by the DAMON maintainer.
-Sufficiently reviewed patches will be queued in `mm-new
-<https://git.kernel.org/akpm/mm/h/mm-new>`_ by the memory management subsystem
-maintainer.  As more sufficient tests are done, the patches will move to
-`mm-unstable <https://git.kernel.org/akpm/mm/h/mm-unstable>`_ and then to
-`mm-stable <https://git.kernel.org/akpm/mm/h/mm-stable>`_.  And finally those
-will be pull-requested to the mainline by the memory management subsystem
-maintainer.
-
-Note again the patches for `mm-new tree
-<https://git.kernel.org/akpm/mm/h/mm-new>`_ are queued by the memory management
-subsystem maintainer.  If the patches require some patches in `damon/next tree
-<https://git.kernel.org/sj/h/damon/next>`_ which have not yet merged in mm-new,
-please make sure the requirement is clearly specified.
-
 Submit checklist addendum
 -------------------------
 
-- 
2.47.3

^ permalink raw reply related	[flat|nested] 4+ messages in thread

* [RFC PATCH 4/4] Docs/mm/damon/maintainer-profile: update key cycle dates for damon.git
  2026-11-21 19:33 [RFC PATCH 0/4] mm/damon: update documents for mm-next onboarding SJ Park
  2026-11-21 19:33 ` [RFC PATCH 2/4] Docs/mm/damon/maintainer-profile: use damon.git for patch baselines SJ Park
  2026-11-21 19:33 ` [RFC PATCH 3/4] Docs/mm/damon/maintainer-profile: drop 'SCM Trees' section SJ Park
@ 2026-11-21 19:33 ` SJ Park
  2 siblings, 0 replies; 4+ messages in thread
From: SJ Park @ 2026-11-21 19:33 UTC (permalink / raw)
  Cc: SJ Park, Andrew Morton, David Hildenbrand, Jonathan Corbet,
	Randy Dunlap, Shuah Khan, damon, linux-doc, linux-mm

Right after 7.5-rc1, DAMON will onboard the mm-next transition [1].  It
will make a few changes to the expected timeline for patches.  Update
'key cycle dates' to align with the changes.

[1] https://lore.kernel.org/bed81e01-7303-4957-bd7d-38e3a094e96f@kernel.org/

Signed-off-by: SJ Park <sj@kernel.org>
---
 Documentation/mm/damon/maintainer-profile.rst | 24 +++++++++++++++----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
index f9a8df2b11e73..75ad74b5b6e93 100644
--- a/Documentation/mm/damon/maintainer-profile.rst
+++ b/Documentation/mm/damon/maintainer-profile.rst
@@ -41,11 +41,25 @@ Further doing below and putting the results will be helpful.
 Key cycle dates
 ---------------
 
-Patches can be sent anytime.  Key cycle dates of the `mm-new
-<https://git.kernel.org/akpm/mm/h/mm-new>`_, `mm-unstable
-<https://git.kernel.org/akpm/mm/h/mm-unstable>`_ and `mm-stable
-<https://git.kernel.org/akpm/mm/h/mm-stable>`_ trees depend on the memory
-management subsystem maintainer.
+Patches can be sent to and reviewed on the mailing lists anytime.
+
+Patches that are sufficiently reviewed will be merged into damon.git
+``for-next`` or ``for-next-fixes`` trees.  The destination tree is decided
+based on the urgency of the patches.  Non-urgent patches are merged into
+``for-next``.  Urgent patches are merged into ``for-next-fixes``.  Being merged
+into damon.git is only for additional review and testing.  All patches in
+damon.git can be reviewed, modified and dropped at any time.
+
+Patches in ``for-next-fixes`` tree stay there for at least one week, for
+additional review and testing.  After that, those would be pull-requested to
+the mainline.
+
+Patches in ``for-next`` tree stay there at least two weeks, for additional
+review and testing.  After that, those would be pull-requested to the mainline,
+in the next merge window.
+
+``for-next`` tree is closed for new patches from -rc6 release to next -rc1
+release.
 
 Review cadence
 --------------
-- 
2.47.3

^ permalink raw reply related	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2026-11-21 19:33 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-21 19:33 [RFC PATCH 0/4] mm/damon: update documents for mm-next onboarding SJ Park
2026-11-21 19:33 ` [RFC PATCH 2/4] Docs/mm/damon/maintainer-profile: use damon.git for patch baselines SJ Park
2026-11-21 19:33 ` [RFC PATCH 3/4] Docs/mm/damon/maintainer-profile: drop 'SCM Trees' section SJ Park
2026-11-21 19:33 ` [RFC PATCH 4/4] Docs/mm/damon/maintainer-profile: update key cycle dates for damon.git SJ Park

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox