From patchwork Thu Jan 16 20:41:26 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Hartmut Goebel X-Patchwork-Id: 37090 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 EADFC27BBE2; Thu, 16 Jan 2025 20:42:27 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-7.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED, RCVD_IN_VALIDITY_CERTIFIED,RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE, SPF_HELO_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 1C70327BBE9 for ; Thu, 16 Jan 2025 20:42:25 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tYWgp-0006oz-8g; Thu, 16 Jan 2025 15:42:07 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tYWgn-0006oX-0t for guix-patches@gnu.org; Thu, 16 Jan 2025 15:42:05 -0500 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tYWgm-0004AM-O8 for guix-patches@gnu.org; Thu, 16 Jan 2025 15:42:04 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=In-Reply-To:References:From:MIME-Version:Date:To:Subject; bh=VZTCNWhhwfRwO8U/z422H57J/fRcdP0+zzauRyQ5GH8=; b=of5ayuY1m4uedEbGQoeTOJl/4wxjsLbgJNsPdpYVeCGaV8juUFVC07z2l4zzYxH24eM9eDhyqy6O6+OB0JrXyXJq61v6y9M5VjQR8Ef7RfEa/j1haNZCbXUWFVVbdcR2YkeG6oSC24ZbLXJoWy5bfrwtTd5V/mPYIWfrPHKl9AfLjX5odpf548W9iJ26NZwrrosqLj/TpjrnP3BooNRzpAydStPgbKZBqbHIRGtywxcSRJtH75EloYuG2YZ2kI5dndprLA8Czfh4GtBADb7a7rSs2SzBo+u7EoHG1fUEmPztg1ldmjSauluA9Jck54ZZmYuLc/IEuhtXplLTG0pwBQ==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tYWgk-0003Mq-Ic for guix-patches@gnu.org; Thu, 16 Jan 2025 15:42:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#74736] [PATCH v2 0/1] Add Request-For-Comment process. Resent-From: Hartmut Goebel Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 16 Jan 2025 20:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74736 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?utf-8?q?Court=C3=A8s?= , Simon Tournier Cc: 74736@debbugs.gnu.org Received: via spool by 74736-submit@debbugs.gnu.org id=B74736.173706009612903 (code B ref 74736); Thu, 16 Jan 2025 20:42:02 +0000 Received: (at 74736) by debbugs.gnu.org; 16 Jan 2025 20:41:36 +0000 Received: from localhost ([127.0.0.1]:34818 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tYWgJ-0003M3-Lj for submit@debbugs.gnu.org; Thu, 16 Jan 2025 15:41:36 -0500 Received: from mail01.noris.net ([62.128.1.221]:43631) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tYWgG-0003Lp-7n for 74736@debbugs.gnu.org; Thu, 16 Jan 2025 15:41:34 -0500 Received: from p57b08759.dip0.t-ipconnect.de ([87.176.135.89] helo=hermia.goebel-consult.de) by mail01.noris.net with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim) (envelope-from ) id 1tYWgE-0002IL-NC; Thu, 16 Jan 2025 21:41:30 +0100 Received: from [127.0.0.1] (hermia.goebel-consult.de [192.168.110.7]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by hermia.goebel-consult.de (Postfix) with ESMTPS id 38405662D8; Thu, 16 Jan 2025 21:41:27 +0100 (CET) Message-ID: Date: Thu, 16 Jan 2025 21:41:26 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird From: Hartmut Goebel References: <438ced5f-5dae-4832-8efd-3243d909fd4c@crazy-compilers.com> <87wmey9zxu.fsf_-_@gnu.org> Content-Language: de-DE, en-US Autocrypt: addr=h.goebel@crazy-compilers.com; keydata= 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 OY6DWb43/DE= Organization: crazy-compilers.com In-Reply-To: X-Noris-IP: 87.176.135.89 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches Hi, enclosed please find a patch for v9. It proposes descriptions for missing states, cases and transitions. I found it easier to create the patch than describing what I propose to change. This patch does *not* include my proposals from my other mails today, but new ones. In addition, I suggest exchanging "Process Overview" and "Roles". I left this away to keep the patch small. --- 001-gcd-process-v9.md 2025-01-16 19:08:54.591520179 +0100 +++ 001-gcd-process-v9-hg.md 2025-01-16 21:34:52.637787901 +0100 @@ -70,7 +70,9 @@ These day-to-day contributions remain governed by the process described by the manual in its “Contributing” chapter. -## How the Process Works +# How the Process Works + +## Getting Started 1. Clone https://git.savannah.gnu.org/git/guix/guix-consensus-documents.git @@ -85,10 +87,8 @@ one or more people who will support the GCD and participate in discussions by your side (see below). -The GCD is *submitted* once it has at least one sponsor in addition to -the author(s). See “Submission Period” below. - -Submitted GCD is announced at `info-guix@gnu.org`. +Your GCD is now in "draft" state and will be processed as described in +the next sections. ## Roles @@ -116,7 +116,7 @@ translation, reviewing, etc. and more broadly any person feeling part of the Guix community. -## Timeline +## Process Overview A GCD must follow the process illustrated by the diagram below, consisting of several *periods*. @@ -141,18 +141,36 @@ The subsections below detail the various periods and their duration. -### Submission Period (up to 7 days) +## Submission Period (up to 7 days) + +During the Submission Period the authors seek at least one sponsor +(see below) for their *draft* GCD in addition to the author(s). +Contributors can volunteer to be sponsors by publicly replying “I +sponsor” to the authors' announcement. -Anyone can author and submit a GCD as a regular patch and look for -sponsors (see below). The GCD is *submitted* once one or more people -have volunteered to be sponsors by publicly replying “I sponsor”; it is -canceled if no sponsor could be found during that period. The next step -is the *discussion period*. +Once one or more sponsors are found, the authors can *submit* the GCD +(see below) and start the *discussion period*. + +The GCD is *canceled* if no sponsor could be found during that period. Authors may withdraw their GCD at any time; they can resubmit it again later, possibly under a new GCD number. -### Discussion Period (at least 30 days, up to 60 days) +### Submitting the GCD + +[[Some explanation like "Merging the Final GCD". +Plus handling the case that the author disappears:]] + +The *discussion period* shall be started within 7 days after +submission. After that, the stale GCD may be set to *withdrawn* by a +Maintainer of the Guix project. + + +## Discussion Period (at least 30 days, up to 60 days) + +The *discussion period* starts when the authors +announce the submission of the GCD at both `info-guix@gnu.org` +and `guix-devel@gnu.org`. Once submitted, the GCD is publicly discussed by all the members of the community. Authors are encouraged to publish updated versions @@ -164,7 +182,14 @@ of the discussion period, the author(s) may publish a final version and announce the start of the *deliberation period*. -### Deliberation Period (14 days) +The *deliberation period* shall be started within 7 days after the end +of the discussion period. After that, the stale GCD may be set to +*withdrawn* by a Maintainer of the Guix project. + +## Deliberation Period (14 days) + +The *deliberation period* starts when the authors +publish a final version of the GCD at `guix-devel@gnu.org`. Deliberation aims at consolidating consensus; see “Decision Making” below. @@ -230,17 +255,19 @@ Texts](https://www.gnu.org/licenses/fdl-1.3.html) or (at your option) any later version. -## GCD Template +# Related Documents + +* **GCD Template**: The expected structure of GCDs is captured by the template in the file `000-template.md`, written in English with Markdown syntax. -## Cost of Reverting +# Cost of Reverting The GCD process described in this document can be amended by subsequent GCDs. -## Drawbacks +# Drawbacks There is a risk that the additional process will hinder contribution more than it would help. We should stay alert that the process is only a way to help @@ -251,7 +278,7 @@ and notably avoid repeating arguments, avoid using exclusionary jargon, and solicit opinions of those who remained silent. -## Open Issues +# Open Issues There are still questions regarding the desired scope of the process. While we want to ensure that technical changes that affect users are