From patchwork Wed Jan 1 16:34:46 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Ludovic_Court=C3=A8s?= X-Patchwork-Id: 19504 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 0661F179D5; Wed, 1 Jan 2020 16:36:16 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id B6431179D3 for ; Wed, 1 Jan 2020 16:36:15 +0000 (GMT) Received: from localhost ([::1]:59842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1imgyl-0001B8-1V for patchwork@mira.cbaines.net; Wed, 01 Jan 2020 11:36:15 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:34386) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1imgyc-00017o-K9 for guix-patches@gnu.org; Wed, 01 Jan 2020 11:36:07 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1imgya-00067T-6A for guix-patches@gnu.org; Wed, 01 Jan 2020 11:36:06 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:59744) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1imgya-000675-3B for guix-patches@gnu.org; Wed, 01 Jan 2020 11:36:04 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1imgyZ-0002EC-1I for guix-patches@gnu.org; Wed, 01 Jan 2020 11:36:03 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#38846] [PATCH 4/4] DRAFT doc: Add a cooption policy for commit access. Resent-From: Ludovic =?utf-8?q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 01 Jan 2020 16:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 38846 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 38846@debbugs.gnu.org Cc: Ludovic =?utf-8?q?Court=C3=A8s?= , guix-maintainers@gnu.org Received: via spool by 38846-submit@debbugs.gnu.org id=B38846.15778965068451 (code B ref 38846); Wed, 01 Jan 2020 16:36:02 +0000 Received: (at 38846) by debbugs.gnu.org; 1 Jan 2020 16:35:06 +0000 Received: from localhost ([127.0.0.1]:37481 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1imgxd-0002CA-Ov for submit@debbugs.gnu.org; Wed, 01 Jan 2020 11:35:06 -0500 Received: from eggs.gnu.org ([209.51.188.92]:51737) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1imgxZ-0002B5-Js for 38846@debbugs.gnu.org; Wed, 01 Jan 2020 11:35:01 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38145) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1imgxU-0003cC-EV; Wed, 01 Jan 2020 11:34:56 -0500 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=47372 helo=gnu.org) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1imgxT-00045M-JQ; Wed, 01 Jan 2020 11:34:56 -0500 From: Ludovic =?utf-8?q?Court=C3=A8s?= Date: Wed, 1 Jan 2020 17:34:46 +0100 Message-Id: <20200101163446.5132-4-ludo@gnu.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200101163446.5132-1-ludo@gnu.org> References: <20200101163446.5132-1-ludo@gnu.org> MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches DRAFT: Subject to discussion! * doc/contributing.texi (Commit Access): Draft a cooptation policy. --- doc/contributing.texi | 48 +++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 46 insertions(+), 2 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 74b4718eb3..6e2cc1a369 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1099,8 +1099,52 @@ this nifty tool! @cindex commit access, for developers For frequent contributors, having write access to the repository is -convenient. When you deem it necessary, feel free to ask for it on the -mailing list. When you get commit access, please make sure to follow +convenient. When you deem it necessary, consider applying for commit +access by following these steps: + +@enumerate +@item +Find three committers who would vouch for you, emailing a signed +statement to @email{guix-maintainers@@gnu.org} (a private alias for the +collective of maintainers). You can view the list of committers at +@url{https://savannah.gnu.org/project/memberlist.php?group=guix}. + +Committers are expected to have had some interactions with you as a +contributor and to be able to judge whether you are sufficiently +familiar with the project's practices. It is @emph{not} a judgment on +the quality of your work, so a refusal should rather be interpreted as +``let's try again later''. + +@item +Send @email{guix-maintainers@@gnu.org} a signed message stating your +intent, listing the three committers who support your application, and +giving the fingerprint of the OpenPGP key you will use to sign commits +(see below). + +@item +Once you've been given access, please send a message to +@email{guix-devel@@gnu.org} to say so, again signed with the OpenPGP key +you will use to sign commits. That way, everyone can notice and ensure +you control that OpenPGP key. + +@c TODO: Add note about adding the fingerprint to the list of authorized +@c keys once that has stabilized. + +@item +Make sure to read the rest of this section and... profit! +@end enumerate + +@quotation Note +Maintainers are happy to give commit access to people who have been +contributing for some time and have a track record---don't be shy and +don't underestimate your work! + +However, note that the project is working towards a more automated patch +review and merging system, which, as a consequence, may lead us to have +fewer people with commit access to the main repository. Stay tuned! +@end quotation + +When you get commit access, please make sure to follow the policy below (discussions of the policy can take place on @email{guix-devel@@gnu.org}).