From patchwork Thu Jan 16 17:55:53 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Simon Tournier X-Patchwork-Id: 37104 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 017AB27BBEA; Fri, 17 Jan 2025 05:20:16 +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=-6.6 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,DKIM_VALID,FREEMAIL_FROM,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 7104227BBE2 for ; Fri, 17 Jan 2025 05:20:15 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tYem6-0000uM-Lw; Fri, 17 Jan 2025 00:20:08 -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 1tYem4-0000u5-1d for guix-patches@gnu.org; Fri, 17 Jan 2025 00:20:04 -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 1tYem3-00014U-EI for guix-patches@gnu.org; Fri, 17 Jan 2025 00:20:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=9FurNx4sgBRMbcTBnSit2bdVQYtod2BLxYciuHMvN5w=; b=iHbo3AP7dWHQLMm32JNKrgG0DK0RTvQuZQmAu0eQFdxiyfijAlTnWoDO5OLK268qe2c55vLI5VY33zKCcRDu5yDrCp44/DxG+pmy1Omy2FPcrYrAy2u0ehsOUfgXRTVr9hVA0BYCXnvcesOfjCZ4m/qNthyF4RODU0svH0XsjVNMHS0Z/qDC3A51IFRvoh5n8Qrvf9DgjAwi6oyucqymBg8M05ies2DJjwCvypgaKmJBTPYKinStjQiBr6e0dqdHsq6NKTsLXQDyM7rZ0dNH3Irr3GJuCimjKfDk4ICAJU+iIMfhZjohDts0hnlwT91EmsrM6O+kA8S4Kn7IeK9+5g==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tYem3-000335-9p for guix-patches@gnu.org; Fri, 17 Jan 2025 00:20:03 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#74736] [PATCH v9] Add Guix Consensus Document process Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 17 Jan 2025 05:20:03 +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: 74736@debbugs.gnu.org Cc: GNU Guix maintainers , pukkamustard , =?utf-8?q?No=C3=A9?= Lopez , bokr@bokr.com, Efraim Flashner , Suhail Singh , Ricardo Wurmus , Vagrant Cascadian , Andreas Enge , Hartmut Goebel , Christopher Baines , "Artyom V. Poptsov" , Ludovic =?utf-8?q?Court?= =?utf-8?q?=C3=A8s?= , Janneke Nieuwenhuizen Received: via spool by 74736-submit@debbugs.gnu.org id=B74736.173709116311627 (code B ref 74736); Fri, 17 Jan 2025 05:20:03 +0000 Received: (at 74736) by debbugs.gnu.org; 17 Jan 2025 05:19:23 +0000 Received: from localhost ([127.0.0.1]:35679 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tYelO-00031R-DD for submit@debbugs.gnu.org; Fri, 17 Jan 2025 00:19:23 -0500 Received: from mail-wm1-x334.google.com ([2a00:1450:4864:20::334]:60860) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1tYUCB-0001dp-AE for 74736@debbugs.gnu.org; Thu, 16 Jan 2025 13:02:20 -0500 Received: by mail-wm1-x334.google.com with SMTP id 5b1f17b1804b1-4361f664af5so13096685e9.1 for <74736@debbugs.gnu.org>; Thu, 16 Jan 2025 10:02:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1737050533; x=1737655333; darn=debbugs.gnu.org; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc:subject:date:message-id:reply-to; bh=9FurNx4sgBRMbcTBnSit2bdVQYtod2BLxYciuHMvN5w=; b=B9kP+d4M6dFnzk/dvFo2y6gZ89awrpEyg2lyxfSgO5WV/36W1u1+CM3pCg+9jgKShH 6cxBC/wgdPExiBzF5YxhoPcbN+2CRGxiTUYo3Pfr5CxVf0gcSL1oLnukymD79RkV1M/6 6fe2kB9GThLFWM4bSkXK38ukaMkowHNJ8y/yEziAoXT9I7+bfT6CFDZT09wlnw+aqbyv S80UyCoyvH192d/Qihs5k/AqLbiKY7jii4/sizLdmI703sB2HKwmaASlPW2YxhmzOIAl tOcYKS7tOsP+JxO4wUZtht4Kqgp49g0dSGS8F86/dWe0z1gZsczHe/fsUgK00eE7gw8b YYhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737050533; x=1737655333; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=9FurNx4sgBRMbcTBnSit2bdVQYtod2BLxYciuHMvN5w=; b=xQQZFGb5IOKMhPKEUMra2hNdlF3FO91Y0e1KNXmPP9n1YlTaP2+RytYMUxUhV8Y6zl vIVNlj2vBFIkccR6gyugxaPMHiOj1M8jUI3+KZoJCpUr6ERQo6omJ1QHY2XZdhbo31cL qtKYkxhlQQ9oJx6+kWkzKohDEncS9ufo6+BO1V3ec95gX8QoyYpWcyRuofcTjAgMmkbk lJ/EJD41PXICF+jKqbxHV6+jrdggp84c7hc+tBKHM7T8etSoIUe15P7qIU6owjdwFSrD 16Qi/xAeiD5a+MmLKs8pb3tUPZqSsudAh/y5cBrC9+0mXrgUUMQKsAjOrXUAQQZ7LYuI /PeA== X-Gm-Message-State: AOJu0YwPuPEF3uwbaQ99zRKSuoKEssQqRJEn0SVrSLNwyy5OdBQhzR/G AXvBFF6clA5yEntXVZagfXgFKWaJkxzm5IgMH/6wFFThqU9Zsf4g X-Gm-Gg: ASbGnct5ZLqphgA88Ww+iN5zf4tmTxw3uaIiLGfGD5eougOsvrlymqtXTxV31NO0s3Q RQolZKweSFjX2EsB2oDbgl2ghgtqIv7khE80RAToFjFZ8eMqKUu3tv9774uNJapECoE2cTxEHZj Cc4vp19YGa+aXC9WA5fAU3+zG9Nl6d9ACuTRTtIPemQaI/T2gSM00XKGN1A1oRECmheGC2lbLCJ cvh0KdrjMlK/iX+zoUoJ8AlCxWnTAH+Ag5Af6FoBUMlIGcmSMRnOzepZ4nIc//atc41GS0pgHuj GhPUCXcOinvYknVoz75SIROU60aYCTxpQ3/on1bxYw== X-Google-Smtp-Source: AGHT+IF3kGzC0cPdil5vg5I2sjMvSotrMI71gTA5AC4ooPLvRLEN+b4qLTzKfO+zVcdFeGx5MPcZoQ== X-Received: by 2002:a05:6000:1561:b0:38a:9f47:557b with SMTP id ffacd0b85a97d-38a9f47568cmr21158930f8f.40.1737050532609; Thu, 16 Jan 2025 10:02:12 -0800 (PST) Received: from lili (roam-nat-fw-prg-194-254-61-41.net.univ-paris-diderot.fr. [194.254.61.41]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-437c7499884sm68489005e9.5.2025.01.16.10.02.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 16 Jan 2025 10:02:11 -0800 (PST) From: Simon Tournier In-Reply-To: References: Date: Thu, 16 Jan 2025 18:55:53 +0100 Message-ID: <8734hiskwm.fsf@gmail.com> MIME-Version: 1.0 X-Mailman-Approved-At: Fri, 17 Jan 2025 00:19:21 -0500 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, Please find attach the v9; I hope it addresses the comments. Attached the diff and the document. The minor changes are: • Point alone “1. Clone …” • Replace remaining RFC with GCD. • Add a sentence about “Sponsor” role. • Add the role of “Contributor”. • Tweak the artist view of the Timeline • Explicit mention that everyone can participate to the “Discussion Period”. And mention that the main concerns and/or opposition are collected to the final document. • Move upfront the aim of “Deliberation Period”. Remove a redundant sentence. • Explicit mention the state ‘deprecated’. WDYT? Cheers, simon --- -- diff -u /tmp/001-gcd-process-v8.md /tmp/001-gcd-process-v9.md --- /tmp/001-gcd-process-v8.md 2025-01-16 16:51:08.758030546 +0100 +++ /tmp/001-gcd-process-v9.md 2025-01-16 18:43:01.835296714 +0100 @@ -73,7 +73,7 @@ ## How the Process Works 1. Clone - https://git.savannah.gnu.org/git/guix/guix-consensus-documents.git . + https://git.savannah.gnu.org/git/guix/guix-consensus-documents.git 2. Copy `000-template.md` to `XYZ-short-name.md` where `short-name` is a short descriptive name and `XYZ` is the sequence number. 3. Write your GCD following the template’s structure. The GCD must not @@ -92,15 +92,16 @@ ## Roles - - An *author* is the person or one of the persons submitting the RFC. + - An *author* is the person or one of the persons submitting the GCD. Authors bear the responsibility to carry out the process to its conclusion. - A *sponsor* is a contributor who, during the submission period (see below), informs the author(s) that they would like to support the - RFC by participating in discussions, providing constructive comments + GCD by participating in discussions, providing constructive comments to help the author(s), soliciting opinions, and acting as - timekeepers. + timekeepers. As a sponsor, please make sure that all have the time + and space for expressing their comments. Sponsors should be contributors who consider being sufficiently familiar with the project’s practices; hence it is recommended, but @@ -111,6 +112,10 @@ members is maintained in the file `etc/teams.scm` in the Guix repository. + - A *contributor* is a person contributing to Guix either with code, + translation, reviewing, etc. and more broadly any person feeling part + of the Guix community. + ## Timeline A GCD must follow the process illustrated by the diagram below, @@ -118,21 +123,20 @@ ``` - +-----------+ - +- - - - - - ->| Withdrawn |<----------------------+ - : +-----------+ | - : ^ | - : : | -+--------------------+ +---------------------+ +---------------------+ -| Submission Period | | Discussion Period | | Deliberation Period | -| (up to 7 days) |-->| (30–60 days) |-->| (14 days) | -+--------------------+ +---------------------+ +---------------------+ - | - | ++--------------------+ +---------------------+ +---------------------+ +| Submission Period | | Discussion Period | | Deliberation Period | +| (up to 7 days) |-X->| (30–60 days) |-->| (14 days) | ++--------------------+ : +---------------------+ +---------------------+ + : : : | + : v : | + : declined v | + : o-----------o | + +- - - - - - - - ->| Withdrawn |<----------------- X + o-----------o | V - +----------+ - | Accepted | - +----------+ + o----------o + | Accepted | + o----------o ``` The subsections below detail the various periods and their duration. @@ -150,8 +154,11 @@ ### Discussion Period (at least 30 days, up to 60 days) -Once submitted, the GCD is publicly discussed; authors are encouraged to -publish updated versions incorporating feedback during the discussion. +Once submitted, the GCD is publicly discussed by all the members of the +community. Authors are encouraged to publish updated versions +incorporating feedback during the discussion; members are encouraged to +share a summary of their main concerns or opposition, if any, for being +included under section “Open Issues” in the document. When deemed appropriate, between 30 days and 60 days after the start of the discussion period, the author(s) may publish a final version and @@ -159,8 +166,11 @@ ### Deliberation Period (14 days) -All team members can participate in deliberation and are encouraged to -do so. +Deliberation aims at consolidating consensus; see “Decision Making” +below. + +Anyone who is a team member is a deliberating member and is encouraged +to contribute to the deliberation. Once the final version is published, team members have 14 days to send one of the following replies on the patch-tracking entry of the GCD: @@ -176,13 +186,6 @@ reply, and (2) no one disapproves. In other cases, the GCD is *withdrawn*. -Deliberation aims at consolidating consensus; see “Decision Making” -below. - -Anyone who is a team member is a deliberating member and is encouraged -to contribute to the deliberation. Team members are defined by the -file etc/teams.scm (see “Teams” in the manual). - GCD acceptance is not a rubber stamp; in particular, it does not mean the proposal will effectively be implemented, but it does mean that all the participants consent to its implementation. @@ -215,7 +218,7 @@ `status` to `accepted` or `withdrawn`; adding the URL of the discussion in the `discussion` header; updating the `date` header; if previously-accepted GCDs are deprecated by this new GCD, change the - `status` header accordingly); + `status` header accordingly with `deprecated`); 2. committing everything; 3. announcing the publication of the GCD. Diff finished. Thu Jan 16 18:44:37 2025