Received: by 2002:a25:c593:0:0:0:0:0 with SMTP id v141csp1081583ybe; Wed, 11 Sep 2019 09:05:53 -0700 (PDT) X-Google-Smtp-Source: APXvYqwg7lYFyP6m3OAEfSeNkxeYgTIB5+iXdk0Dr90ctCGRBPgJI7dB6EYeUkt+fdrM9ZEqafMp X-Received: by 2002:a50:d5c5:: with SMTP id g5mr34352371edj.57.1568217953815; Wed, 11 Sep 2019 09:05:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1568217953; cv=none; d=google.com; s=arc-20160816; b=f1nYcrsyMCBDiVUWHoMkmKYv9lomtVm/2hj9gDGKvnsc7o+YQcDIpFynmhFzWziNBU B4Z0pB8d4FjLNERAXuuZ48FfLgZBGS+qR8WWbFaBRIOmzvpK4O3qfStLQXNBzMXKAuWb P4i4PrjCQK2HBKRY3pbeLnqiSefMvpH3DQe/kx2izOW5WvtTg9kpt7sITMteMpf3BCCF Hxy6BkWigu67x7+ls2ptN04uCfnO+Ke5hP3rCVGrPgHQ0E8ADt/pH52pXQMA0w6cn2+P TCUlrQeukPJYwcuj0H9/fgz5MuCzKBcBp1Fin0pPjYj19SQzcVQ7xFmlT+uoQFLrQEBo NFHg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :user-agent:message-id:date:cc:to:from:subject; bh=emoVt/VPdYaU6cMblNekL/+eteyomXclDzekNNvhcyA=; b=WVkKkdb/dEamypW/SxOUG6bMdlqATaWbhK50YBw8vJME1a3V0JxKuSb5oob2bTzxjn iFNcrl2r/QxcShGEHYrC9tXqwyKGsieVkJ3180H6/KYGsDTg/NUb4+RFrGE63Y4NeV9q tPSxdIJ82C1aVTOWqtppNhCOl9eDClVURI/racsRtcv+pG/CGBD50j6ULXLSTp3ff5Nv aOvzdzS+Ojol+wBdbskA2aU7btzQJg5YhDdQ0f4VEqOnDVOWg9gmZ85PcAPN2ZIqWNRM L/Jkya3QwDeH50hX3EolKjkj+L0YYsIAKEZkR3sekjveGeIJrEHikebZB8+CwSMUERCz tn9w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id c4si7393476edy.388.2019.09.11.09.05.28; Wed, 11 Sep 2019 09:05:53 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728916AbfIKQDB (ORCPT + 99 others); Wed, 11 Sep 2019 12:03:01 -0400 Received: from mga05.intel.com ([192.55.52.43]:26157 "EHLO mga05.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728819AbfIKQDB (ORCPT ); Wed, 11 Sep 2019 12:03:01 -0400 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga105.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 11 Sep 2019 09:03:00 -0700 X-IronPort-AV: E=Sophos;i="5.64,492,1559545200"; d="scan'208";a="268788464" Received: from dwillia2-desk3.jf.intel.com (HELO dwillia2-desk3.amr.corp.intel.com) ([10.54.39.16]) by orsmga001-auth.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 11 Sep 2019 09:03:00 -0700 Subject: [PATCH v2 0/3] Maintainer Entry Profiles From: Dan Williams To: linux-kernel@vger.kernel.org Cc: Mauro Carvalho Chehab , Dave Jiang , Daniel Vetter , Linus Torvalds , Dmitry Vyukov , Vishal Verma , Jonathan Corbet , Thomas Gleixner , Joe Perches , "Tobin C. Harding" , Alexandre Belloni , "Martin K. Petersen" , Greg Kroah-Hartman , Steve French , Olof Johansson , linux-nvdimm@lists.01.org, ksummit-discuss@lists.linuxfoundation.org Date: Wed, 11 Sep 2019 08:48:42 -0700 Message-ID: <156821692280.2951081.18036584954940423225.stgit@dwillia2-desk3.amr.corp.intel.com> User-Agent: StGit/0.18-2-gc94f MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Changes since v1 [1]: - Simplify the profile to a hopefully non-controversial set of attributes that address the most common sources of contributor confusion, or maintainer frustration. - Rename "Subsystem Profile" to "Maintainer Entry Profile". Not every entry in MAINTAINERS represents a full subsystem. There may be driver local considerations to communicate to a submitter in addition to wider subsystem guidelines. - Delete the old P: tag in MAINTAINERS rather than convert to a new E: tag (Joe Perches). [1]: http://lore.kernel.org/r/154225759358.2499188.15268218778137905050.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, and the Maintainer Handbook more generally, is to provide a desk reference for maintainers both new and experienced. 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. There are quite a few of people who have been around long enough to make enough mistakes that they have gained some hard earned proficiency. However if the kernel community expects to keep growing it needs to be able both scale the maintainers it has and ramp new ones without necessarily let them make a decades worth of mistakes to learn the ropes. To be clear, the proposed document does not impose or suggest new rules. Instead it provides an outlet to document the unwritten rules and policies in effect for each subsystem, and that each subsystem might decide differently for whatever reason. --- 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 | 99 ++++++++++++++++++++ Documentation/nvdimm/maintainer-entry-profile.rst | 64 +++++++++++++ MAINTAINERS | 20 ++-- 4 files changed, 175 insertions(+), 9 deletions(-) create mode 100644 Documentation/maintainer/maintainer-entry-profile.rst create mode 100644 Documentation/nvdimm/maintainer-entry-profile.rst