From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id MDokDaZXDWeEAwAA62LTzQ:P1 (envelope-from ) for ; Mon, 14 Oct 2024 17:40:54 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id MDokDaZXDWeEAwAA62LTzQ (envelope-from ) for ; Mon, 14 Oct 2024 19:40:54 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=hSXFhKYY; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=E5MppnA8; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1728927653; a=rsa-sha256; cv=none; b=uR67ddh3+eln8CdMSUbwn/wjeWrJTQhkRkapykgwqmevzEFOIAm4gizUExOfjkqGQnxQLy VOvqOkfCbZv5K5zFp2jU3r7aCRy/DgOl+Odd/mGQfH/eAA/n5UFN6SHEIB8JtIoys3h87d ngaGp8teA3DelX6/JTs0JRW1BXRViCaLMrU8M62Sft9AeBs4RGgjVHyGPwwtLMYuu3CYqQ GDQDZ06h2v9isv5CBk7AAzsis+H083haYcfMSs5uV79KX9NEjuhrONlbtjiDKeNC8eB+rh s/gIOo49PT/sCk+R4wIKHsD7AOArt4dmrPUOAgGBlHN/jYJSLH5lECyz5vL6IQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=hSXFhKYY; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=E5MppnA8; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1728927653; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=7T4B19tNKizwxczRHBuqfIH9mGO+FatmP0jcMLhT0ok=; b=FO85rnXq2Hut7gJp4V/v8RY0/sAt5UXDWzOJUysHtz4ajUf+rzn3Pacuf5Oj4tVR7sOJCv RD+W+s6iNaE595i2CcTUF/5LmfZunyCz7M2pzKTc/x5UW8Ro4Q8YRNawNCQuwR43kHDKsH kyMtPr+3Wn2enr2uEUH8qY/8iQeRoIjZSnv5XEJWcy7LShRJTMxBLlLeYMZ+JRfN74ebp4 ckYdpCpgtRCUs2aHG4jHr20/JXXihjgS4rYfSpMw7g8fcESQ8QeHfdCrVkqjIfVzUwp2CE GPymMB9t1hgSjJykfTSxISMePpcWvhS4rIqNMqDQnaZ7/y0K+uVB6GZeW1RJow== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id B12D13C81 for ; Mon, 14 Oct 2024 19:40:53 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1t0P3q-0003Kq-MF; Mon, 14 Oct 2024 13:40:50 -0400 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 1t0P3o-0003Kg-53 for guix-patches@gnu.org; Mon, 14 Oct 2024 13:40:48 -0400 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 1t0P3l-0000f5-Kl; Mon, 14 Oct 2024 13:40:46 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:References:In-Reply-To:Date:From:To:Subject; bh=7T4B19tNKizwxczRHBuqfIH9mGO+FatmP0jcMLhT0ok=; b=hSXFhKYYDydzRb0eqE1zfXtvq/VHXelP90EGHGomRoWoxFZWwD07ZGa6FAQn6hFZsbIEzF5bTsOSZntulhmr/o7jjxL9jwtuxnOFBDlU47Lvr+h54P8jvUy8p4u5MOpJDqt9fZ16KKThgmDUWHIwYIiUpIm6kAHbxMcqZvVsfrfF360acxP1qsErBERgB1qpC/LpuqxGVu3+0lk0k287QUZxmllohAlO9hFbOOYoY0ybTG/NMKFRHiEM8gTuOAxsVBIqX9D+kImH9TJsVyArLgH/6W13ilLQwtctsSfIAqXBlte6WYWGHNUCF2AtxWv51V2NkDAv/6iOnAAGbJJLTQ==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1t0P42-0004Fx-KZ; Mon, 14 Oct 2024 13:41:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#73803] [PATCH 1/2] doc: Add =?UTF-8?Q?=E2=80=9CMaking_?= =?UTF-8?Q?Decisions=E2=80=9D?= section. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: ludo@gnu.org, maxim.cournoyer@gmail.com, guix-patches@gnu.org Resent-Date: Mon, 14 Oct 2024 17:41:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73803 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 73803@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer X-Debbugs-Original-Xcc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer Received: via spool by 73803-submit@debbugs.gnu.org id=B73803.172892761415832 (code B ref 73803); Mon, 14 Oct 2024 17:41:02 +0000 Received: (at 73803) by debbugs.gnu.org; 14 Oct 2024 17:40:14 +0000 Received: from localhost ([127.0.0.1]:43703 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0P3F-00047C-Dd for submit@debbugs.gnu.org; Mon, 14 Oct 2024 13:40:14 -0400 Received: from eggs.gnu.org ([209.51.188.92]:44618) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0Owf-0003fJ-DL for 73803@debbugs.gnu.org; Mon, 14 Oct 2024 13:33:26 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1t0Ou4-0008AB-Ux; Mon, 14 Oct 2024 13:30:52 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=7T4B19tNKizwxczRHBuqfIH9mGO+FatmP0jcMLhT0ok=; b=E5MppnA8ZkHqqVhsgq1D Odc2CDrEnF1NsNOMbjOCXqnTuZhDPuh6D1NnbSWzGczK5ZAQwz/hzgz+9p1f91c41BJRzKWPNaRtK 18itt/YsUXi4B+7ND3uaHO4/g7IFUWVlJrxYajZF0/nQebp1NmgI1bAsY1znqjZ5QyVco8oQn6bzW w7mCn+RjKFZn9M0wR7eG60Ezf5vH3ETW18xJKdEq3Dwxjem0y+rvxNuDIQZF4TO/f6JN3rPgJej3E xVRCocqjxDKzUxBo2Ovus0yW4G4h5NpwXSrYGpVEUDi8xw+pFJWHkKMiFuE51lHncFirPJyXT+rbg Hsz4tGlmYXnFiQ==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 14 Oct 2024 19:30:36 +0200 Message-ID: X-Mailer: git-send-email 2.46.0 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: 2.77 X-Spam-Score: 2.77 X-Migadu-Queue-Id: B12D13C81 X-Migadu-Scanner: mx12.migadu.com X-TUID: G70XeWSDPrZ5 Suggested by Simon Tournier . * doc/contributing.texi (Making Decisions): New section, with paragraphs moved from… (Commit Access): … here. Cross-reference it. (Teams): Likewise. Change-Id: Ib276242e0ec7598a1b60dacdde8647bd3d3b85d3 --- doc/contributing.texi | 45 +++++++++++++++++++++++++++---------------- 1 file changed, 28 insertions(+), 17 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index acdc303be6..cc6e84013a 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -31,6 +31,7 @@ Contributing * Coding Style:: Hygiene of the contributor. * Submitting Patches:: Share your work. * Tracking Bugs and Changes:: Keeping it all organized. +* Making Decisions:: Collectively choosing the way forward. * Commit Access:: Pushing to the official repository. * Reviewing the Work of Others:: Some guidelines for sharing reviews. * Updating the Guix Package:: Updating the Guix package definition. @@ -2233,10 +2234,8 @@ Teams and review the work of individuals in its scope (@pxref{Reviewing the Work of Others}); it can make decisions within its scope, in agreement with other teams whenever there is overlap or a close connection, and in -accordance with other project rules such as seeking consensus. -@c TODO: Currently ``consensus-based decision making'' is discussed -@c under ``Commit Access''. Move that elsewhere and refer to it from -@c here. +accordance with other project rules such as seeking consensus +(@pxref{Making Decisions}). As an example, the Python team is responsible for core Python packaging matters; it can decide to upgrade core Python packages in a dedicated @@ -2706,6 +2705,25 @@ Cuirass Build Notifications where each RSS entry contains a link to the Cuirass build details page of the associated build. +@node Making Decisions +@section Making Decisions + +@cindex decision making +@cindex consensus seeking +It is expected from all contributors, and even more so from committers, +to help build consensus and make decisions based on consensus. By using +consensus, we are committed to finding solutions that everyone can live +with. It implies that no decision is made against significant concerns +and these concerns are actively resolved with proposals that work for +everyone. + +A contributor (who may or may not have commit access) wishing to block +a proposal bears a special responsibility for finding alternatives, +proposing ideas/code or explain the rationale for the status quo to +resolve the deadlock. To learn what consensus decision making means and +understand its finer details, you are encouraged to read +@url{https://www.seedsforchange.org.uk/consensus}. + @node Commit Access @section Commit Access @@ -2721,19 +2739,10 @@ Commit Access thought of as a ``badge of honor'' but rather as a responsibility a contributor is willing to take to help the project. -It is expected from all contributors, and even more so from committers, -to help build consensus and make decisions based on consensus. By using -consensus, we are committed to finding solutions that everyone can live -with. It implies that no decision is made against significant concerns -and these concerns are actively resolved with proposals that work for -everyone. - -A contributor (who may or may not have commit access) wishing to block -a proposal bears a special responsibility for finding alternatives, -proposing ideas/code or explain the rationale for the status quo to -resolve the deadlock. To learn what consensus decision making means and -understand its finer details, you are encouraged to read -@url{https://www.seedsforchange.org.uk/consensus}. +Committers are in a position where they enact technical decisions. Such +decisions must be made by @emph{actively building consensus} among +interested parties and stakeholders. @ref{Making Decisions}, for more +on that. The following sections explain how to get commit access, how to be ready to push commits, and the policies and community expectations for commits @@ -3006,6 +3015,8 @@ Reviewing the Work of Others the project to keep bikes dry.}. As a reviewer, try hard to explain the rationale for suggestions you make, and to understand and take into account the submitter's motivation for doing things in a certain way. +In other words, build consensus with everyone involved (@pxref{Making +Decisions}). @end enumerate @cindex LGTM, Looks Good To Me -- 2.46.0