[PATCH 11/11] doc: move drm-misc maintainer guidelines

Jani Nikula jani.nikula at intel.com
Thu Oct 25 15:22:11 UTC 2018


Move drm-misc under the common maintainer guidelines.

Signed-off-by: Jani Nikula <jani.nikula at intel.com>
---
 drm-misc.rst              | 44 ----------------------------------------
 maintainer-drm-misc.rst   | 51 +++++++++++++++++++++++++++++++++++++++++++++++
 maintainer-guidelines.rst |  1 +
 3 files changed, 52 insertions(+), 44 deletions(-)
 create mode 100644 maintainer-drm-misc.rst

diff --git a/drm-misc.rst b/drm-misc.rst
index 832aeb33ffe9..b55a5f49e5a8 100644
--- a/drm-misc.rst
+++ b/drm-misc.rst
@@ -43,47 +43,3 @@ releases at the same time. Big features take a long time to hit a kernel
 release. There are no fast paths.
 
 .. include:: drm-misc-timeline.rst
-
-Maintainer's Duties
-===================
-
-Maintainers mostly provide services to keep drm-misc running smoothly:
-
-* Coordinate cross-subsystem dependencies and handle topic branches, sending out
-  pull request and merging topic pull requests from other subsystems.
-
-* At least once per week check for pending bugfixes (using ``dim status``) and
-  if there are any (either in `-fixes` or `-next-fixes`), send out the pull
-  request.
-
-* Fast-forward (when possible) `-fixes` to each released -rc kernel tag, to
-  keep it current. We try to avoid backmerges for bugfix branches, and rebasing
-  isn't an option with multiple committers.
-
-* Pull requests become noisy if `-fixes` has been fast-forwarded to Linus'
-  latest -rc tag but drm-upstream hasn't done the same yet: The shortlog
-  will contain not just the queued fixes but also anything else that has
-  landed in Linus' tree in the meantime. The best practice is then to base
-  the pull request on Linus' master branch (rather than drm-upstream) by
-  setting the `upstream` argument for ``dim pull-request`` accordingly.
-  Upstream should be warned that they haven't fast-forwarded yet.
-
-* During the merge-window blackout, i.e. from -rc6 on until the merge window
-  closes with the release of -rc1, try to track `drm-next` with the
-  `-next-fixes` branch. Do not advance past -rc1, otherwise the automagic in
-  the scripts will push the wrong patches to the linux-next tree.
-
-* Between -rc1 and -rc6 send pull requests for the `-next` branch every 1-2
-  weeks, depending upon how much is queued up.
-
-* Backmerge `drm-next` into the `-next` branch when needed, properly recording
-  that reason in the merge commit message. Do a backmerge at least once per
-  month to avoid conflict chaos, and specifically merge in the main drm feature
-  pull request, to resync with all the late driver submissions during the merge
-  window.
-
-* Last resort fallback for applying patches, in case all area expert committers
-  are somehow unavailable.
-
-* Take the blame when something goes wrong. Maintainers interface and represent
-  the entire group of committers to the wider kernel community.
diff --git a/maintainer-drm-misc.rst b/maintainer-drm-misc.rst
new file mode 100644
index 000000000000..462deff5b04c
--- /dev/null
+++ b/maintainer-drm-misc.rst
@@ -0,0 +1,51 @@
+.. _maintainer-drm-misc:
+
+================================
+ drm-misc Maintainer Guidelines
+================================
+
+This document describes the detailed maintainer tasks for drm-misc.
+
+Maintainer's Duties
+===================
+
+Maintainers mostly provide services to keep drm-misc running smoothly:
+
+* Coordinate cross-subsystem dependencies and handle topic branches, sending out
+  pull request and merging topic pull requests from other subsystems.
+
+* At least once per week check for pending bugfixes (using ``dim status``) and
+  if there are any (either in `-fixes` or `-next-fixes`), send out the pull
+  request.
+
+* Fast-forward (when possible) `-fixes` to each released -rc kernel tag, to
+  keep it current. We try to avoid backmerges for bugfix branches, and rebasing
+  isn't an option with multiple committers.
+
+* Pull requests become noisy if `-fixes` has been fast-forwarded to Linus'
+  latest -rc tag but drm-upstream hasn't done the same yet: The shortlog
+  will contain not just the queued fixes but also anything else that has
+  landed in Linus' tree in the meantime. The best practice is then to base
+  the pull request on Linus' master branch (rather than drm-upstream) by
+  setting the `upstream` argument for ``dim pull-request`` accordingly.
+  Upstream should be warned that they haven't fast-forwarded yet.
+
+* During the merge-window blackout, i.e. from -rc6 on until the merge window
+  closes with the release of -rc1, try to track `drm-next` with the
+  `-next-fixes` branch. Do not advance past -rc1, otherwise the automagic in
+  the scripts will push the wrong patches to the linux-next tree.
+
+* Between -rc1 and -rc6 send pull requests for the `-next` branch every 1-2
+  weeks, depending upon how much is queued up.
+
+* Backmerge `drm-next` into the `-next` branch when needed, properly recording
+  that reason in the merge commit message. Do a backmerge at least once per
+  month to avoid conflict chaos, and specifically merge in the main drm feature
+  pull request, to resync with all the late driver submissions during the merge
+  window.
+
+* Last resort fallback for applying patches, in case all area expert committers
+  are somehow unavailable.
+
+* Take the blame when something goes wrong. Maintainers interface and represent
+  the entire group of committers to the wider kernel community.
diff --git a/maintainer-guidelines.rst b/maintainer-guidelines.rst
index 335d29a6e2bb..496c82ba5c64 100644
--- a/maintainer-guidelines.rst
+++ b/maintainer-guidelines.rst
@@ -9,4 +9,5 @@ This document gathers together maintainer guidelines.
 .. toctree::
    :maxdepth: 2
 
+   maintainer-drm-misc
    maintainer-drm-intel
-- 
2.11.0



More information about the dim-tools mailing list