From fa8e00338c41b79af197bde59552e586c8eb2e88 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= Date: Fri, 10 Apr 2026 16:05:52 +0200 Subject: [PATCH] doc: Mention the GCD process. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * doc/contributing.texi (Making Decisions): Document GCDs. Change-Id: I8b247af4e6ec731bc7750e19519c8dba863e5ef5 Signed-off-by: Ludovic Courtès Merges: #7786 --- doc/contributing.texi | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/contributing.texi b/doc/contributing.texi index bf375f9ef5c..2062557933b 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -2650,6 +2650,7 @@ applications settings page}, granting read/write access to the @cindex decision making @cindex consensus seeking +Every contribution to the project involves a form of decision making. 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 @@ -2664,6 +2665,26 @@ 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}. +Day-to-day decision making, for instance discussions about pull requests +(@pxref{Reviewing the Work of Others}), happens informally among +interested parties such as contributors and members of the relevant +teams (@pxref{Teams}). + +@cindex GCD, Guix Consensus Documents +@cindex Guix Consensus Documents (GCD) +Decisions that are expected to have an impact on most contributors +and/or on the broader user community---e.g., changes to project-wide +policies, to core functionality, and so on---are made following the +@acronym{GCD, Guix Consensus Document} process. The process provides a +framework to formalize proposals and draw attention to them, to leave +time for interested parties to discuss them, and to collectively accept +or withdraw them based on input from participating team members. It is +defined in +@uref{https://consensus.guix.gnu.org/gcd/001-gcd-process.html, +GCD@tie{}001}. Past GCDs can be seen at +@uref{https://consensus.guix.gnu.org}, and discussions take place at +@uref{https://codeberg.org/guix/guix-consensus-documents}. + @node Commit Access @section Commit Access