summaryrefslogtreecommitdiff
path: root/Documentation/maintainer/index.rst
diff options
context:
space:
mode:
authorTobin C. Harding <me@tobin.cc>2017-12-04 02:27:29 +0300
committerJonathan Corbet <corbet@lwn.net>2017-12-12 00:43:24 +0300
commit9727a0144bd99f4a189a2ededd52c53299079d8a (patch)
treec8fedac9b3888e0f145eb8dc6b1c968c29f33725 /Documentation/maintainer/index.rst
parentb6e859f6cdd1686c021dcb3e18591d0b28ce8867 (diff)
downloadlinux-9727a0144bd99f4a189a2ededd52c53299079d8a.tar.xz
doc: add maintainer book
There is currently very little documentation in the kernel on maintainer level tasks. In particular there are no documents on creating pull requests to submit to Linus. Quoting Greg Kroah-Hartman on LKML: Anyway, this actually came up at the kernel summit / maintainer meeting a few weeks ago, in that "how do I make a good pull request to Linus" is something we need to document. Here's what I do, and it seems to work well, so maybe we should turn it into the start of the documentation for how to do it. (quote references: kernel summit, Europe 2017) Create a new kernel documentation book 'how to be a maintainer' (suggested by Jonathan Corbet). Add chapters on 'configuring git' and 'creating a pull request'. Most of the content was written by Linus Torvalds and Greg Kroah-Hartman in discussion on LKML. This is stated at the start of one of the chapters and the original email thread is referenced in 'pull-requests.rst'. Signed-off-by: Tobin C. Harding <me@tobin.cc> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Mauro Carvalho Chehab <mchehab@s-opensource.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation/maintainer/index.rst')
-rw-r--r--Documentation/maintainer/index.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/Documentation/maintainer/index.rst b/Documentation/maintainer/index.rst
new file mode 100644
index 000000000000..fa84ac9cae39
--- /dev/null
+++ b/Documentation/maintainer/index.rst
@@ -0,0 +1,10 @@
+==========================
+Kernel Maintainer Handbook
+==========================
+
+.. toctree::
+ :maxdepth: 2
+
+ configure-git
+ pull-requests
+