From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.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 mCQgHt2h2GZqdwEAqHPOHw:P1 (envelope-from ) for ; Wed, 04 Sep 2024 18:07:25 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id mCQgHt2h2GZqdwEAqHPOHw (envelope-from ) for ; Wed, 04 Sep 2024 20:07:25 +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=I83WaVA5; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=mUg594Yq; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none); 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=1725473245; 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=18ibWB9hLr5QPE+1+6kV1nYNKoa2imPtVA+Bw7f/IFw=; b=WHO0aK0lc+MNUeyLR/SoSmckOuqCysjdehvBEJJ2j18id2+aYh6fOX/TXTufR7ifBZ+O8B kSz+ErRKkjExEXkNRmCVdBbEFNOe2vnJnEy9OEe9Mqcqtrq5qB7/jH96mriDLLTkl7+csU S55eAbdY4Bv6hugdHbXgicZmAulfHEn0OOWFyCWw6/DfgbiCD5cz43MRhhODuP3PFW9IGu ooY5Pyc71uPuxM5dkWTipWUlPpGWLeUMF6VtdcIk5kD0Aeduo2IZi3HgDyxF0+spQoPytk s4vPUPODGa6qErWIvpUKB9N19enypdm2MvdWtvIzBoRr6369+rm694vOoxEDNw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1725473245; a=rsa-sha256; cv=none; b=Ta0Jm0JhpQTGfUHg50ed6j83cbHvzuRN2AMut3mNgIsv8p/acR5gQXMlzQ557MnbOY2TiD HKzaJ4xSWveL0XKkrwglaRQxwFVks5XlkmHzhUZrbu6KteCt46r0NQpQHm/rrJYXLSi79R /7J+6IVjdhg6scioyVwjfd21BMq6fUNZ3lomfOLOqAUpLJgfFPONCMSthSauOHJWGVho01 PlQ/m3A4yXZNxy8P+QeQnJPylXQwkQoKLGmnBxTh0SdOlGmz76uy2T0MzMSDJOtuxgUnvk d9U7/aTH9KfPzweURh+230h74O7sNsMZrQcJO/mXTRpJF294XrHqv6AykkKIwA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=I83WaVA5; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=mUg594Yq; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none); 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" 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 EB3156A2F5 for ; Wed, 4 Sep 2024 20:07:24 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sluPP-0004hc-Lb; Wed, 04 Sep 2024 14:07:11 -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 1sluPM-0004h6-Kg for guix-patches@gnu.org; Wed, 04 Sep 2024 14:07:09 -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 1sluPE-00089H-JQ; Wed, 04 Sep 2024 14:07:07 -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=18ibWB9hLr5QPE+1+6kV1nYNKoa2imPtVA+Bw7f/IFw=; b=I83WaVA5MwYuwWahmPHWYcb365O53AkEpwbQFh146fLSBORqh7L1Lr/5M9PvyTkp5psGpSrpIzt4VrgcmAbW+hJP5g6OjHZy+T0/t60rJQwH6b4NU0GZjeCARBQ51J3FuRNE9aqCw+3ACS5/3oI297bafDGZT0Ays8AzHLfwqsy5xfouTbodGPWzwcapi76r+w7D64csb5igUQGi8Ja0Els4qhsSnmY7vgbXv+jIbDPlOkV6azAS3R3RdDp197RqWLariLZX/QxlPNEexhe/P6CSdaXlycnvLHZ5cR228Lhn1+IDtczefHaz22HWlW9/M074hQW1M2EP5U8dFcqnyg==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sluQF-00019v-8K; Wed, 04 Sep 2024 14:08:03 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72891] [PATCH v2 3/3] doc: Define the purpose, membership, and creation of teams. Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: pelzflorian@pelzflorian.de, ludo@gnu.org, maxim.cournoyer@gmail.com, guix-patches@gnu.org Resent-Date: Wed, 04 Sep 2024 18:08:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72891 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 72891@debbugs.gnu.org Cc: Simon Tournier , Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer X-Debbugs-Original-Xcc: Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer Received: via spool by 72891-submit@debbugs.gnu.org id=B72891.17254732764425 (code B ref 72891); Wed, 04 Sep 2024 18:08:03 +0000 Received: (at 72891) by debbugs.gnu.org; 4 Sep 2024 18:07:56 +0000 Received: from localhost ([127.0.0.1]:35373 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ7-00019I-I7 for submit@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:55 -0400 Received: from mail-wm1-f42.google.com ([209.85.128.42]:42460) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ5-00018f-IR for 72891@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:54 -0400 Received: by mail-wm1-f42.google.com with SMTP id 5b1f17b1804b1-42ba9b47f4eso6351995e9.1 for <72891@debbugs.gnu.org>; Wed, 04 Sep 2024 11:06:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725473144; x=1726077944; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=18ibWB9hLr5QPE+1+6kV1nYNKoa2imPtVA+Bw7f/IFw=; b=mUg594YqLzdQgfAdnefSd9SJtIaEYTcBrD75vsB0mZamuiulBcdNB1cWgvkZd4+O8R SlPEOzKNQeplPDidMYd9DabCYH16MvX8FhWYk2MiUd8MlCZhIn+NVipr2YRhtu2jEGXJ GYdOW6/N4c8qvNwVue/3e1W/yXsn8wq234a0mA9KRh7oWhCCw8M7YxbUcbkjCet4bSHX dyjnV6/90QJnLgIKubq9n5EIvH0oVwBcLg3RncVpc8siARNk8R1RI58zKGFw2fH8PVw4 Fd5T8IGud1JnzFWK5GhwXCSwRHIbGb2fVKfalAI1XBMzQ4CXtRkRugTk4R/V0+gQH+3u c+eg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725473144; x=1726077944; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=18ibWB9hLr5QPE+1+6kV1nYNKoa2imPtVA+Bw7f/IFw=; b=UN+l47EoVLPAnCA4BCdOjeksnN2XU48qI83vIdLvsrUaFW2yv1D12gT+qjKUgsMd2Z 8XZxXqiGld7RCoNOj8lQiQmsqmOUpVX3Y+v2eN3W5CN+j+56HzAY9QrEZ7Hlr2hezcLl vqZgRtyQCrqWWi21xS2Db0VjOzyWcXYDRywhipBdL9lz5Y4TxzfvgCrdY832H54fCcyb EUwb1+GY7xv5P6ys6D1jN9Mpx7AWvpNg70ic8RH09M2/vEU6o/oqHwX+j1jFPlXRO076 FYRNqW0mfx28o7FmWJfXVWJLqmAJRQyJ45BDqI0+JiTh6sk7RuFcWFdtXCa/Mp5mi75/ UVEQ== X-Gm-Message-State: AOJu0YzZaJFRIFMrCgxz4pB4cQNXeQ4ibZX08bPNSDMg7o/5/8iW6PaI Oe96I817bb1wlnuEjLDJdXC/uaXQt5dGxKS9N1d5ONva+SpeOvBH9K1Rzg== X-Google-Smtp-Source: AGHT+IGBidl5yPX9kVUk49uy8xb7LS5osNJFsiOzL0XIIxSl78da2JmiyUgp1FZLzdLwPeuZ0xDhOA== X-Received: by 2002:a05:600c:5249:b0:42a:b32b:cc65 with SMTP id 5b1f17b1804b1-42c95ac1794mr19235345e9.2.1725473143650; Wed, 04 Sep 2024 11:05:43 -0700 (PDT) Received: from lili.. ([2a01:e0a:59b:9120:b32f:9ceb:a68d:c5bf]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-374c958c471sm9476120f8f.25.2024.09.04.11.05.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 11:05:43 -0700 (PDT) From: Simon Tournier Date: Wed, 4 Sep 2024 20:05:34 +0200 Message-ID: <85a6c932a8d4b742f66d1469be21c448b1e34526.1725472527.git.zimon.toutoune@gmail.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <4c46c09e486681f749d837e9c8cac7f5309436ce.1725472527.git.zimon.toutoune@gmail.com> References: <4c46c09e486681f749d837e9c8cac7f5309436ce.1725472527.git.zimon.toutoune@gmail.com> 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-Queue-Id: EB3156A2F5 X-Migadu-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -8.92 X-Spam-Score: -8.92 X-TUID: mu6+qPWz6VTm * doc/contributing.texi (Teams): Define the purpose of teams; provide example; clarify membership and team creation. (Reviewing the Work of Others): Link to “Teams”. Change-Id: Ibefbde1654ac8dd2321eb977fbcd3966b8fb8e01 --- doc/contributing.texi | 56 ++++++++++++++++++++++++++++++++++++------- 1 file changed, 48 insertions(+), 8 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 06edaef77d..af2c044f71 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -2871,8 +2871,51 @@ Teams @section Teams @cindex teams -There are several teams mentoring different parts of the Guix source -code. To list all those teams, you can run from a Guix checkout: +To organize work on Guix, including but not just development efforts, +the project has a set of @dfn{teams}. Each team has its own focus and +interests and is the primary contact point for questions and +contributions in those areas. A team's primary mission is to coordinate +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 +(@pxref{Consensus Decision}). + +As an example, the Python team is responsible for core Python packaging +matters; it can decide to upgrade core Python packages in a dedicated +@code{python-team} branch, in collaboration with any team whose scope is +directly dependent on Python---e.g., the Science team---and following +branching rules (@pxref{Managing Patches and Branches}). The +Documentation team helps review changes to the documentation and can +initiate overarching documentation changes. The Translations team +organizes translation of Guix and its manual and coordinates efforts in +that area. The Core team is responsible for the development of core +functionality and interfaces of Guix; because of its central nature, +some of its work may require soliciting input from the community at +large and seeking consensus before enacting decisions that would affect +the entire community. Other said, teams provide feedback on patches +touching its scope (@pxref{Reviewing the Work of Others}). + +Teams are defined in the @file{etc/teams.scm} file in the Guix +repository. The scope of each team is defined, when applicable, as a +set of files or as a regular expression matching file names. + +@cindex team membership +Anyone with interest in a team's domain and willing to contribute to its +work can apply to become a member by contacting current members by +email; commit access is not a precondition. Membership is formalized by +adding the person's name and email address to @file{etc/teams.scm}. +Members who have not been participating in the team's work for one year +or more may be removed; they are free to reapply for membership later. + +@cindex team creation +One or more people may propose the creation of a new team by reaching +out to the community by email at @email{guix-devel@@gnu.org}, clarifying +the intended scope and purpose. When consensus is reached on the +creation of this team, someone with commit access formalizes its +creation by adding it and its initial members to @file{etc/teams.scm}. + +To list existing teams, run the following command from a Guix checkout: @example $ ./etc/teams.scm list-teams @@ -2880,15 +2923,12 @@ Teams name: Mentors description: A group of mentors who chaperone contributions by newcomers. members: -+ Christopher Baines -+ Ricardo Wurmus -+ Mathieu Othacehe -+ jgart -+ Ludovic Courtès ++ Charlie Smith @dots{} @end example -You can run the following command to have the @code{Mentors} team put in +@cindex mentoring +You can run the following command to have the Mentors team put in CC of a patch series: @example -- 2.45.2