From: Dan Williams <dan.j.williams@intel.com>
To: corbet@lwn.net
Cc: Mauro Carvalho Chehab <mchehab@kernel.org>,
Daniel Vetter <daniel.vetter@ffwll.ch>,
Linus Torvalds <torvalds@linux-foundation.org>,
Dmitry Vyukov <dvyukov@google.com>,
Thomas Gleixner <tglx@linutronix.de>,
Joe Perches <joe@perches.com>, "Tobin C. Harding" <me@tobin.cc>,
Alexandre Belloni <alexandre.belloni@bootlin.com>,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Steve French <stfrench@microsoft.com>,
Olof Johansson <olof@lixom.net>,
Paul Walmsley <paul.walmsley@sifive.com>,
linux-kernel@vger.kernel.org, linux-nvdimm@lists.01.org,
linux-doc@vger.kernel.org
Subject: [PATCH v3 0/3] Maintainer Entry Profiles
Date: Sun, 24 Nov 2019 12:59:42 -0800 [thread overview]
Message-ID: <157462918268.1729495.10257190766638995699.stgit@dwillia2-desk3.amr.corp.intel.com> (raw)
Changes since v2 [1]:
- Drop any consideration for coding style concerns in the profile. It
was a minor aspect of the proposal that generated the bulk of the
feedback on v2. Lets make progress on the rest.
- Clarify that the "Submit Checklist Addendum" can also include details
that submitters need to take into account before even beginning to
craft a patch. This is in response to the RISC-V use case of
declaring specification readiness as a patch gate, and is now also used
by the libnvdimm subsystem to clarify details about ACPI NVDIMM Device
Specific Method specifications. (Paul)
- Non-change from v2: Kees had asked for a common directory for all
profiles to live, but Mauro noted that this could be handled later
with some scripting to post-process the MAINTAINERS file, or otherwise
converting MAINTAINERS to ReST.
- Clarify the cover letter to focus on the contributor focused
Maintainer Entry Profiles, and defer discussion of a maintainer
focused Handbook.
[1]: https://lore.kernel.org/ksummit-discuss/156821692280.2951081.18036584954940423225.stgit@dwillia2-desk3.amr.corp.intel.com/
---
At last years Plumbers Conference I proposed the Maintainer Entry
Profile as a document that a maintainer can provide to set contributor
expectations and provide fodder for a discussion between maintainers
about the merits of different maintainer policies.
For those that did not attend, the goal of the Maintainer Entry Profile
is to provide contributors documentation of patch submission
considerations that may vary by subsystem. The session introduction was:
The first rule of kernel maintenance is that there are no hard and
fast rules. That state of affairs is both a blessing and a curse. It
has served the community well to be adaptable to the different
people and different problem spaces that inhabit the kernel
community. However, that variability also leads to inconsistent
experiences for contributors, little to no guidance for new
contributors, and unnecessary stress on current maintainers.
To be clear, the proposed document does not impose or suggest new rules.
Instead it provides an outlet to document the existing unwritten
policies in effect for a given subsystem. Over time the hope is that
some of this variability can be up-levelled to new global process
policy, but in the meantime it provides relief for communicating the
guidelines that are being imposed on contributors.
---
Dan Williams (3):
MAINTAINERS: Reclaim the P: tag for Maintainer Entry Profile
Maintainer Handbook: Maintainer Entry Profile
libnvdimm, MAINTAINERS: Maintainer Entry Profile
Documentation/maintainer/index.rst | 1
.../maintainer/maintainer-entry-profile.rst | 87 ++++++++++++++++++++
Documentation/nvdimm/maintainer-entry-profile.rst | 59 ++++++++++++++
MAINTAINERS | 20 +++--
4 files changed, 158 insertions(+), 9 deletions(-)
create mode 100644 Documentation/maintainer/maintainer-entry-profile.rst
create mode 100644 Documentation/nvdimm/maintainer-entry-profile.rst
_______________________________________________
Linux-nvdimm mailing list -- linux-nvdimm@lists.01.org
To unsubscribe send an email to linux-nvdimm-leave@lists.01.org
next reply other threads:[~2019-11-24 21:14 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-11-24 20:59 Dan Williams [this message]
2019-11-24 20:59 ` [PATCH v3 1/3] MAINTAINERS: Reclaim the P: tag for Maintainer Entry Profile Dan Williams
2019-11-24 20:59 ` [PATCH v3 2/3] Maintainer Handbook: " Dan Williams
2019-11-24 20:59 ` [PATCH v3 3/3] libnvdimm, MAINTAINERS: " Dan Williams
2019-11-25 15:50 ` [PATCH v3 0/3] Maintainer Entry Profiles Jonathan Corbet
2019-11-25 16:41 ` Dan Williams
2019-11-25 16:51 ` Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=157462918268.1729495.10257190766638995699.stgit@dwillia2-desk3.amr.corp.intel.com \
--to=dan.j.williams@intel.com \
--cc=alexandre.belloni@bootlin.com \
--cc=corbet@lwn.net \
--cc=daniel.vetter@ffwll.ch \
--cc=dvyukov@google.com \
--cc=gregkh@linuxfoundation.org \
--cc=joe@perches.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-nvdimm@lists.01.org \
--cc=mchehab@kernel.org \
--cc=me@tobin.cc \
--cc=olof@lixom.net \
--cc=paul.walmsley@sifive.com \
--cc=stfrench@microsoft.com \
--cc=tglx@linutronix.de \
--cc=torvalds@linux-foundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).