Received: by 2002:ad5:474a:0:0:0:0:0 with SMTP id i10csp7585256imu; Wed, 14 Nov 2018 21:06:32 -0800 (PST) X-Google-Smtp-Source: AJdET5cMUfxqYqmtgiwPXIr/KJFkX9988BaKqd90DeNHpUFi1HCd3uNx9TIM2PLpCcUObVQx9wbp X-Received: by 2002:a62:5c41:: with SMTP id q62-v6mr5015816pfb.171.1542258392597; Wed, 14 Nov 2018 21:06:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1542258392; cv=none; d=google.com; s=arc-20160816; b=DPufu51YkoMENC35HWDbx562s1OavSfVbQmyXOUjg6MTm3USt3qizp6xIG5g2hNQ68 yh6WFEIdGBEFTxJRorqq6yNNrFQy2DDbk+Uc/VPfvX3JQVt4KT9SDdkPBF8g9JtCBoxI TXTohq4zSquyCAToPCmnixuKp0R8J68olIfH6JQzifBBVkpLl4+3CAstPxJDsTBuTB64 cQCfh6wB86OFJsjQFDr8T+0DuDmOe05HPmA2uHdZhDOuy6nantzwLs3QQdGo7FXqYZKF 3O0RRWsId+DK1N0+Dg26EuBF/4x+3HPyTf72QtLuiOqYsxAXFJPwezlOwv5GLFteXnAT Q2dQ== 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=lmz/3N0iY3AnIDeGmonz+be842duz3ki67jPyAMZJ88=; b=BJNeL5jDAnf6L344BQz/6Tc1lqB9nn1+HWcHqF+6JZuJmDXmm7BIvoOcpE1Zuc6LZK DAvEeU24sFwSXvDVEkgLyxn08gQXzf2KPUTq16aSgq2nS7dFF9IgbvyAo3kW5mGFCqxy aH+KpsYMsHKlqY4j6CgUN3EyWT4fxExB3DXfzm73iL36ersWwuLwZOklR9C/y0sE76g9 DQVvpnc9sUQQ2o8xYC8yMl7kihJUoqeZap02zVTlPTeGjvmll/tqay1hHhRbXRx79FLe j/Smnz+GuArgBFi6zktXcilqTl8IN3l5ASFYWW4wyYN7fHX39uglE0rmXlM1a5ivSRPv mAwQ== 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 s12si26577771pgh.488.2018.11.14.21.06.03; Wed, 14 Nov 2018 21:06:32 -0800 (PST) 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 S1727067AbeKOPLU (ORCPT + 99 others); Thu, 15 Nov 2018 10:11:20 -0500 Received: from mga17.intel.com ([192.55.52.151]:34713 "EHLO mga17.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726689AbeKOPLU (ORCPT ); Thu, 15 Nov 2018 10:11:20 -0500 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 14 Nov 2018 21:05:02 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,235,1539673200"; d="scan'208";a="85945985" Received: from dwillia2-desk3.jf.intel.com (HELO dwillia2-desk3.amr.corp.intel.com) ([10.54.39.16]) by fmsmga007.fm.intel.com with ESMTP; 14 Nov 2018 21:05:02 -0800 Subject: [RFC PATCH 0/3] Maintainer Handbook: Subsystem Profile 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 , Ross Zwisler , Joe Perches , "Tobin C. Harding" , "Martin K. Petersen" , Greg Kroah-Hartman , Steve French , Olof Johansson , corbet@lwn.net, linux-nvdimm@lists.01.org, ksummit-discuss@lists.linuxfoundation.org Date: Wed, 14 Nov 2018 20:53:13 -0800 Message-ID: <154225759358.2499188.15268218778137905050.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 At a recently concluded session at the Linux Plumbers Conference I proposed a "Subsystem 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 Subsystem 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 Subsystem Profile MAINTAINERS, Handbook: Subsystem Profile libnvdimm, MAINTAINERS: Subsystem Profile Documentation/maintainer/index.rst | 1 Documentation/maintainer/subsystem-profile.rst | 145 ++++++++++++++++++++++++ Documentation/nvdimm/subsystem-profile.rst | 86 ++++++++++++++ MAINTAINERS | 26 +++- 4 files changed, 249 insertions(+), 9 deletions(-) create mode 100644 Documentation/maintainer/subsystem-profile.rst create mode 100644 Documentation/nvdimm/subsystem-profile.rst