From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 30 06:13:37 2024 Received: (at submit) by debbugs.gnu.org; 30 Aug 2024 10:13:37 +0000 Received: from localhost ([127.0.0.1]:52544 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sjydN-0007vj-0L for submit@debbugs.gnu.org; Fri, 30 Aug 2024 06:13:37 -0400 Received: from lists.gnu.org ([209.51.188.17]:58954) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sjycw-0007p3-8I for submit@debbugs.gnu.org; Fri, 30 Aug 2024 06:13:35 -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 1sjyc0-0003rU-SH for guix-patches@gnu.org; Fri, 30 Aug 2024 06:12:13 -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 1sjybz-0007zl-NB; Fri, 30 Aug 2024 06:12:11 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=6KMi5M2HsbVaDc7Y9cZyuBUkS3zFYbrlVfwJXLVRGzI=; b=EdvL3MNuTVtYW2 lX9U9FLGKRdxTYvhSkMRowkxeMyy4WuzOtMAcytJWGhHhJlw93BQjgooxsb4FNP8sokaB7uJ7lMxp B8s66aZVKAgE3jcpf4uW9UJ06e2lDSUvQwibnDELZ9gUmcsRxIZKNnsmiFHAQ6kMmEnQdqKDwOTca sCTi6mSuhiJpFOMUsB4ugySJZV+mrrszuNCG4ZGe0wvmXuK4zxeUfLAUy4pbLLbmaUnJpQ6yBj+H2 c7CTQT1TlNsQSXYEGc9/U4B7ZkSSIxMet2rEyH8RBS2XUx0uy6lJAcnqd4P1wiUMfPGJNKmh5YDfH 7+A3c7ZFscAJsF7AWrDA==; From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= To: guix-patches@gnu.org Subject: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. Date: Fri, 30 Aug 2024 12:12:04 +0200 Message-ID: X-Mailer: git-send-email 2.45.2 X-Debbugs-Cc: guix-maintainers@gnu.org MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Debbugs-Cc: Florian Pelz , Ludovic Courtès , Maxim Cournoyer Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit Cc: =?UTF-8?q?Ludovic=20Court=C3=A8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * 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: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d --- doc/contributing.texi | 63 ++++++++++++++++++++++++++++++++++++------- 1 file changed, 53 insertions(+), 10 deletions(-) Hello Guix! The recent discussion about creating a browser team¹ made it clear that teams are not defined anywhere: the manual doesn’t say what their mission is, how to become a member, how to revoke members, nor how to create new teams. This patch is an attempt to formalize that. I believe there’s nothing really new for someone who’s been following closely in recent times, but it should definitely improve legibility for newcomers. Thoughts? I suggest that we iterate on this for at most one month so we have a first version checked in by September 30th. Ludo’. ¹ https://lists.gnu.org/archive/html/guix-devel/2024-08/msg00168.html diff --git a/doc/contributing.texi b/doc/contributing.texi index 73f7addbef..7705367bce 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -2225,8 +2225,52 @@ Teams @subsection 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. +@c TODO: Currently ``consensus-based decision making'' is discussed +@c under ``Commit Access''. Move that elsewhere and refer to it from +@c here. + +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. + +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 @@ -2234,15 +2278,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 @@ -2905,12 +2946,14 @@ Reviewing the Work of Others is to review the work contributed by others. You do not need to be a committer to do so; applying, reading the source, building, linting and running other people's series and sharing your comments about your -experience will give some confidence to committers. Basically, you must +experience will give some confidence to committers. You must ensure the check list found in the @ref{Submitting Patches} section has been correctly followed. A reviewed patch series should give the best chances for the proposed change to be merged faster, so if a change you would like to see merged hasn't yet been reviewed, this is the most -appropriate thing to do! +appropriate thing to do! If you would like to review changes in a +specific area and to receive notifications for incoming patches relevant +to that domain, consider joining the relevant team(s) (@pxref{Teams}). @cindex reviewing, guidelines Review comments should be unambiguous; be as clear and explicit as you base-commit: d5312370b46ace47e138d84e1bb28e5651cee94b -- 2.45.2 From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 31 02:27:44 2024 Received: (at 72891) by debbugs.gnu.org; 31 Aug 2024 06:27:45 +0000 Received: from localhost ([127.0.0.1]:53745 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skHaK-0003Rp-KX for submit@debbugs.gnu.org; Sat, 31 Aug 2024 02:27:44 -0400 Received: from smtp2-g21.free.fr ([212.27.42.2]:48610) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skHaH-0003Ra-N5 for 72891@debbugs.gnu.org; Sat, 31 Aug 2024 02:27:42 -0400 Received: from [127.0.0.1] (unknown [84.33.180.62]) (Authenticated sender: noelopez@free.fr) by smtp2-g21.free.fr (Postfix) with ESMTPSA id 23EDE20039E for <72891@debbugs.gnu.org>; Sat, 31 Aug 2024 08:26:11 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=free.fr; s=smtp-20201208; t=1725085572; bh=RuQPtkQETp5FHrvcymKKv2hxM6TZji2BaHBB3aE5Cxg=; h=Date:From:To:Subject:From; b=OEED3LyhVdJYwzi7tdU7GZEvVstMsv6JF1C2nyiR08LZmVxqAkyOZN+c5JimBwROI OALaGeowLHIc73ydsOUghzgCq7gxQcMu7W1FrD9l2/7wGbGZ2H6j/VvsqOPbqSEe9R pr/sdRjRjMLTxgVyI8EepwydDcX3pDlsxfnbA82yAtth20dm3nXvRLeXyhuqMw7cs0 V+OmHstZqDaH7WWBpP5eBSa318hHv5B+zyTirzaOYzVgPi61Kg0+NSt06y2lpHBhw+ Pjvcz4lORnn3o3PpFtDza2I+ghols0drtOv6MEyakd1YmMEE3uC/22vDfTI7aDeOWS 9sHzmMzlFCw6Q== Date: Sat, 31 Aug 2024 08:26:10 +0200 From: =?ISO-8859-1?Q?No=E9_Lopez?= To: 72891@debbugs.gnu.org Subject: =?US-ASCII?Q?=5BPATCH_RFC=5D_doc=3A_Define_the_purpose?= =?US-ASCII?Q?=2C_membership=2C_and_creation_of_teams=2E?= User-Agent: K-9 Mail for Android Message-ID: <12BA420A-4913-45F2-A33D-49CFD0ADF90B@free.fr> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary=----V5F4PSOE7YHIYTVG4OSKD1HHF65VOC Content-Transfer-Encoding: 7bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ------V5F4PSOE7YHIYTVG4OSKD1HHF65VOC Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Clear explanation, thank you=2E If the @dfn doesn't create an index entry t= hen maybe add one for teams :) ------V5F4PSOE7YHIYTVG4OSKD1HHF65VOC Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable
Clear explanation, thank you= =2E If the @dfn doesn't create an index entry then maybe add one for teams = :)
------V5F4PSOE7YHIYTVG4OSKD1HHF65VOC-- From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 31 15:45:49 2024 Received: (at 72891) by debbugs.gnu.org; 31 Aug 2024 19:45:49 +0000 Received: from localhost ([127.0.0.1]:56643 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skU2f-00023a-Jy for submit@debbugs.gnu.org; Sat, 31 Aug 2024 15:45:49 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60582) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skU2d-00023E-Dk for 72891@debbugs.gnu.org; Sat, 31 Aug 2024 15:45:47 -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 1skU1b-0001A9-Km; Sat, 31 Aug 2024 15:44:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=2PALPM/2mFZ0Jw8c2R9eG8z5Em6zirQOTpISnGzdRF8=; b=quvAxUlfVrh9/Ro/kjYE yCKeGzr5utNpG9Wi9ij4PQc2tKSRu+fCxz0KAaLnmmbqgxBZ7VwN6DA23l3t2Hx9iqnUCzeLYzRcD +MJlvifgaGnrJ1zEksi/TA2Daqk2+fSw+tPlw1xtfDHmKcjlhvsBJ8OY2MZBv2RZpMVkae8enrgFh iU6j08784w7RQyVUUGxT8WoFYjHRYq7d8OouWoTt9Bffs0eEyxrR7U7YjVJecR451ASV+nKy9twpM gdgbDuuI9/wZIDDuXSqpbRDojz5bshC8JXm/pLqN6I/rFo/Y2c+7gKHfQRiXmPyPgCCQUX7uSRJsn ueXg7NbBkG1i+Q==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: =?utf-8?Q?No=C3=A9?= Lopez Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <12BA420A-4913-45F2-A33D-49CFD0ADF90B@free.fr> (=?utf-8?Q?=22?= =?utf-8?Q?No=C3=A9?= Lopez"'s message of "Sat, 31 Aug 2024 08:26:10 +0200") References: <12BA420A-4913-45F2-A33D-49CFD0ADF90B@free.fr> Date: Sat, 31 Aug 2024 21:44:40 +0200 Message-ID: <87jzfwfpef.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) No=C3=A9 Lopez skribis: > Clear explanation, thank you. If the @dfn doesn't create an index entry t= hen maybe add one for teams :) Thanks! There was already an =E2=80=9C@cindex teams=E2=80=9D so it should = be good. Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 04 13:58:20 2024 Received: (at 72891) by debbugs.gnu.org; 4 Sep 2024 17:58:20 +0000 Received: from localhost ([127.0.0.1]:35359 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluGq-0000rf-0w for submit@debbugs.gnu.org; Wed, 04 Sep 2024 13:58:20 -0400 Received: from mail-wr1-f46.google.com ([209.85.221.46]:50394) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluGo-0000rP-AC for 72891@debbugs.gnu.org; Wed, 04 Sep 2024 13:58:19 -0400 Received: by mail-wr1-f46.google.com with SMTP id ffacd0b85a97d-374ba4e094aso3273574f8f.0 for <72891@debbugs.gnu.org>; Wed, 04 Sep 2024 10:57:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725472568; x=1726077368; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=sKOceFsUIdD8cHovstRRdbrzABDibv7epBYdghub2VE=; b=lAKH5y7M3SUi7MdggNEJWS7vroPyvYl6JqxjnDzYTrtkeJCN0yd5Xcc0LgiNs0R7lL HSN8xbf3gsmUXhBCN/edPjfKFzs7ghhmozJ/JwQWZ7wGoMoB+nHcjNWljMa+c1e2rzyt mCcVk+8XU70EYeOTJdJpQOj6yQsYWx314RpNja9PYdhOxqX+DNT0LDYuY6wkOOYVy80V fK6S7XYXwhzOUMLHzEElNWA1bvxrKXIYjpwDaS9ftXuyeRwiaFK9Bw3JNi9ONq9iUOEp isj82dtio9+zb178hUPiICmimWQNNBURCBQa+Dfu0b3ie83iA4NKiKCoE97OMPl3VtqH iJ9g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725472568; x=1726077368; h=content-transfer-encoding:mime-version:user-agent: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=sKOceFsUIdD8cHovstRRdbrzABDibv7epBYdghub2VE=; b=nLkVQJu4+jqqs+YJERgrsokfw6AY+IMo+/b3t+cxyHOfEyAEqyOK8L8zjziIB2n5gf Bcuqasj2MuwflXM1jnFosljH9Zd1f35te+J1jWZDgXJiujCO7ZIHJPq9D9SLPLik71xD GSZnMFiEpWX8E8JJOS7qOYWO8uzYtrEGtoNxhEdviHXCml35b+XfsNbCYjaq/Qujt1ZY d4qxmWchesgLgAn6WSQM8zmQxX4KsYVFKp5yV909Ch1Do6EyqvkBOkK9rFV2uSWzEbar eiP+IyS3ivHC3DKPEKa41GoutMoZDy1BFRK9WenUG5gFQehblzzePGt70VMMf8al8q0X LKLQ== X-Gm-Message-State: AOJu0YxnAqwlJBNL0Iw3XfkldVrOOSdxHA/0Hg97olhyQ9YRA4dt3Cn4 wtjEKdW0w/J+pR9X4T2UyAPXNxwAl/ZJsRU3em1PXWBHfzyrOcbG X-Google-Smtp-Source: AGHT+IGCUSHWLcWycTPlgVuJ/MS3qDlu8azvX31SkBJBxIr6yqsFAhDVhAmmYlOEEWIjuH7PtFqhaA== X-Received: by 2002:adf:b31c:0:b0:374:be8e:7322 with SMTP id ffacd0b85a97d-374bf1c9c1amr9598874f8f.45.1725472568283; Wed, 04 Sep 2024 10:56:08 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:b32f:9ceb:a68d:c5bf]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-374c7e62b1esm10188360f8f.36.2024.09.04.10.56.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 10:56:07 -0700 (PDT) From: Simon Tournier To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: ("Ludovic =?utf-8?Q?Court=C3=A8s=22's?= message of "Fri, 30 Aug 2024 12:12:04 +0200") References: Date: Wed, 04 Sep 2024 19:25:23 +0200 Message-ID: <87seufwcu4.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: guix-devel@gnu.org, 72891@debbugs.gnu.org, Florian Pelz , Maxim Cournoyer X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Ludo, As you mentioned elsewhere, this patch deserves the attention of guix-devel, hence CC: guix-devel. :-) [bug#72891] [PATCH RFC] doc: Define the purpose, membership, and creati= on of teams. Ludovic Court=C3=A8s Fri, 30 Aug 2024 12:12:04 +0200 id:fb9721adfc71b841dcb6a2575539449ce756e401.1725012038.git.ludo@gnu.org https://issues.guix.gnu.org/72891 https://issues.guix.gnu.org/msgid/fb9721adfc71b841dcb6a2575539449ce756e= 401.1725012038.git.ludo@gnu.org https://yhetil.org/guix/fb9721adfc71b841dcb6a2575539449ce756e401.172501= 2038.git.ludo@gnu.org Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 04 13:58:23 2024 Received: (at 72891) by debbugs.gnu.org; 4 Sep 2024 17:58:23 +0000 Received: from localhost ([127.0.0.1]:35361 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluGt-0000rv-An for submit@debbugs.gnu.org; Wed, 04 Sep 2024 13:58:23 -0400 Received: from mail-wm1-f47.google.com ([209.85.128.47]:47505) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluGp-0000rS-TT for 72891@debbugs.gnu.org; Wed, 04 Sep 2024 13:58:20 -0400 Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-42c828c8863so30908265e9.3 for <72891@debbugs.gnu.org>; Wed, 04 Sep 2024 10:57:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725472570; x=1726077370; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=jIs8Q/ney8X8+pevC13GgfyMQXRzNdTSFp9OpojqJIc=; b=R14jR7KHMLITXx9dDNeyCTqmFHtCxaNxabiJekZA1xKBGG/U2QvXlHlgso/qIORc2o 6faXDeG1cYyrPITA6WUV1jD1WVMcqh0+m2vkibQNJZdkqXIQhX/SKDOa5Wod6Q9Gt9sj mWzKgmRoyrp5flLY8G6e/TuQ4Ta068cig/TvJFgfpWRTGFeN9WI8Ik+r3BZUFx5fW4VX xTQI4t4EAcP4qQcwa1Fb2EgyDY3BaEbbQVvkdHrMf6VhWW8k+Go1CpPrZdfaTRbEdI/U 9rUPqLwKMBLoRcQYs24r042gMZ1j+bE9xPvDT26cGE8PJVAPpHE2gtsQYGm6KATRjKB2 gy7w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725472570; x=1726077370; h=content-transfer-encoding:mime-version:user-agent: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=jIs8Q/ney8X8+pevC13GgfyMQXRzNdTSFp9OpojqJIc=; b=VTilo3B0N+U1kGyFis5487Aii4aHDcxTBMx13nDfB3kpvrdhj8MTW3svmvv+7mpibs 9HUFpQ/QHIsCwfgDktgHPkuur/Iv+0hye2nLJx6ph7vsFZsqtA6YDzJ/rvmuO4QI5IAR 8O/uc8PNpwBvTGss6Arg50nXBRxB3q8Nre2TmEjYl5BwGzhL0KdV1DlBTcbYf1Liwmfd 8oNhvhq7NnV6/Umd01upQs/auB+hMY4Bqpdxf/Ko6/BXdto/qh+yWUBjwo9AdalyWIXI u3AJHTXasUmhMCbywmK1d6ALhMQ6l8SE5yGb4qttb3K0uUxhy6WAg85kynSpwREdu/RJ b3cQ== X-Gm-Message-State: AOJu0Yzu2ZUWqVJRZ9TnpupOnVuPHYpEsSsrBgIZM4UoSyF9KPTy131a Lyfd+0ABfs1ekQrZ3BCwKogQMTZm/hRaDVjaBspj150u0raBRwK0 X-Google-Smtp-Source: AGHT+IFo4qYkPND0sF3uJS16lkNP8Nwej09Hufyu9dsRLw1SV120/a7D92ZXeLbvb91IH+eg1x22UA== X-Received: by 2002:a05:600c:3485:b0:429:a0d:b710 with SMTP id 5b1f17b1804b1-42bdc63345emr110308205e9.12.1725472569705; Wed, 04 Sep 2024 10:56:09 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:b32f:9ceb:a68d:c5bf]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-374c29aa150sm11760012f8f.101.2024.09.04.10.56.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 10:56:09 -0700 (PDT) From: Simon Tournier To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: ("Ludovic =?utf-8?Q?Court=C3=A8s=22's?= message of "Fri, 30 Aug 2024 12:12:04 +0200") References: Date: Wed, 04 Sep 2024 19:26:53 +0200 Message-ID: <87plpjwcrm.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org, Florian Pelz , Maxim Cournoyer X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, On Fri, 30 Aug 2024 at 12:12, Ludovic Court=C3=A8s wrote: > * doc/contributing.texi (Teams): Define the purpose of teams; provide > example; clarify membership and team creation. > (Reviewing the Work of Others): Link to =E2=80=9CTeams=E2=80=9D. > > Change-Id: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d > --- > doc/contributing.texi | 63 ++++++++++++++++++++++++++++++++++++------- > 1 file changed, 53 insertions(+), 10 deletions(-) This patch LGTM modulo minor comments. ( Aside, I am less and less comfortable to have a manual that collects our practises instead of separated documents. Anyway. :-) ) > +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. > +@c TODO: Currently ``consensus-based decision making'' is discussed > +@c under ``Commit Access''. Move that elsewhere and refer to it from > +@c here. If we are at it. I think this =E2=80=9Csection Teams=E2=80=9D should be mo= ved to its own section and not a subsection of =E2=80=9CSubmitting Patches=E2=80=9D. The =E2=80=9Cconsensus=E2=80=9D should also move to its own section. See v2 for a proposal. > +As an example, the Python team is responsible for core Python packaging [...] > +To list existing teams, run the following command from a Guix checkout: What is missing between the brackets [...] is a link to =E2=80=9CReviewing = the work of others=E2=80=9D. Somehow, I would add a sentence clarifying =E2=80= =9Cits work=E2=80=9D. For instance, I propose a last sentence in the paragraph: --8<---------------cut here---------------start------------->8--- As an example, the Python team is responsible for core Python packaging [...] the entire community. Other said, teams provide feedback on patches touching its scope (@pxref{Reviewing the Work of Others}). --8<---------------cut here---------------end--------------->8--- Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 04 14:07:53 2024 Received: (at 72891) by debbugs.gnu.org; 4 Sep 2024 18:07:53 +0000 Received: from localhost ([127.0.0.1]:35368 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ4-00018s-Gn for submit@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:52 -0400 Received: from mail-wm1-f43.google.com ([209.85.128.43]:61660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ2-00018a-De for 72891@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:51 -0400 Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-42bb8cf8abeso55401565e9.2 for <72891@debbugs.gnu.org>; Wed, 04 Sep 2024 11:06:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725473141; x=1726077941; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=Q5+FenPau939EUibiidPLLnn237cPrWZMRGMlsvG58o=; b=e2NCmNroxt3M2teGG/xcJKcvz1Dkrzrgi4AXZDHcF0T2u2cBc/uRvLfabLTKtHnOVf gJxColb+tMGH/WB/AJJrjSV1A7HGQ5clQ17noI0n1HOBiX7Nl2hsvip4PtRe2Ruw0Pgx XQSHtLMkxTZnfYFuZi4gkbRXD2tJAWn+mA10FYinKYc90//0aDuhxqAily6x9xThWoEW I3urCGI+TzpTKGUT5/tqhY6LbRc2H0qKqLN9zG2SvDdOVSaT303w3ai5NjOnZ32umZ6y 3+YzNzIu/eDOYeKS0OFABHu5jZoynx0oQVLvjfuidEadu3JPuLqbS2/uit6Oa10Rkq4Z k4xg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725473141; x=1726077941; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Q5+FenPau939EUibiidPLLnn237cPrWZMRGMlsvG58o=; b=WRIUPVj9Cs6bFO8B8sSD3VlUlClmK+1ooNXf6zmyRtsUfnoWGNVfrdlCkWrmY8mxIx pDcXYY82QAarflTLZni7G6Bk2MuprTwFrP/nlhUVonnTbxFU5FzlE3Cv+91DiK/MG3+O VbIYD7EELbFuTZnvY68S8O3MKLIPGbsQtTc/9cinUmxXIECBaDs8unDMWgKUrUaXCzkS DWQZkGN7MQ8jluNbQwmcEmWvCYA5o7lSiuZQH9xxbcQe7V9bbck7K9onlEKtMNP6DzVP v4w3K7VvhUuMGn+SfJJ6or2wup/wsGQklu6Nh7Jpm7GX6Vev0dGfjn9XCiv2VrdokNsN yxCw== X-Gm-Message-State: AOJu0YzDtcyRDy9s7ZnA0EYkOEVuF7KXx+chCxwaPWWEIN5az1H34wDI GJEta2XWvyjXPqRiXgL/Erz/4vKi5rq/sVfqQ2o/3g2lVeEhvSjhGSkIrQ== X-Google-Smtp-Source: AGHT+IGiwehf0vt9u1QBP6P36htqfEOsl3cv5E3kRhvdpx4EdvHKx9xUB2jTarSNsT6NO43cNPSJfg== X-Received: by 2002:a05:600c:3b9f:b0:428:f0c2:ef4a with SMTP id 5b1f17b1804b1-42c8de7b0a9mr36731965e9.13.1725473140662; Wed, 04 Sep 2024 11:05:40 -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.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 11:05:40 -0700 (PDT) From: Simon Tournier To: 72891@debbugs.gnu.org Subject: [PATCH v2 1/3] doc: contributing: Move consensus. Date: Wed, 4 Sep 2024 20:05:32 +0200 Message-ID: <4c46c09e486681f749d837e9c8cac7f5309436ce.1725472527.git.zimon.toutoune@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-Debbugs-Cc: Florian Pelz , Ludovic Courtès , Maxim Cournoyer Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) * doc/contributing.texi (Consensus Decision): New section. Ccommit Access): Move consensus decision to its section. Change-Id: I7f35b5cea5f7a7a6facbe0ef6f0fdbd98d8a68a7 --- doc/contributing.texi | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 73f7addbef..46d316294a 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. +* Consensus Decision:: Deciding based on consensus. * 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. @@ -2664,6 +2665,19 @@ Cuirass Build Notifications where each RSS entry contains a link to the Cuirass build details page of the associated build. +@node Consensus Decision +@section Consensus Decision + +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 (which 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 @@ -2679,16 +2693,8 @@ 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 (which 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}. +consensus and make decisions based on consensus (@pxref{Consensus +Decision}). The following sections explain how to get commit access, how to be ready to push commits, and the policies and community expectations for commits base-commit: 7fa9df431e9423e2b79c8c520de1d0ef7aed910d -- 2.45.2 From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 04 14:07:54 2024 Received: (at 72891) by debbugs.gnu.org; 4 Sep 2024 18:07:54 +0000 Received: from localhost ([127.0.0.1]:35371 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ6-000195-0J for submit@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:54 -0400 Received: from mail-wr1-f51.google.com ([209.85.221.51]:44492) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sluQ4-00018d-6G for 72891@debbugs.gnu.org; Wed, 04 Sep 2024 14:07:52 -0400 Received: by mail-wr1-f51.google.com with SMTP id ffacd0b85a97d-374c84dcc90so750816f8f.1 for <72891@debbugs.gnu.org>; Wed, 04 Sep 2024 11:06:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725473142; x=1726077942; 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=fTih648E5bAUQQXwKuTZGEJylGu8/xmu3zOZO5cOLlg=; b=PWJFEUolpr/+YapOBjwDd5Cb9Cr/CtTW+zlbDsZD9LYsQlnb4+PRBVyDvg5yGGmjZ3 6HkLmuATNll9QgYewy3JI9ZeN84qZzX+Zcg9ZLWAWRtdkTreOnNAcfoBYodKApT++2TB 8r8ZD7rtLkBSI7bK/8U5BzEm66k/1TVvFP0LaFGgeeAip7RYTlypknbhcDJGIGql1OFj 9OH6FcSDSPoxBmp2XmL9c/dNTYDcciJOqDIslACn5yvvheZGQFw/gVkRh37Va5eVWGPw cSIg7nT3gbZ7aPbg1w07Wd7sB7a5XrqCEF/iYeF11jOCEWaYu4ceGdTSPG9mThh0WZr/ wF3A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725473142; x=1726077942; 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=fTih648E5bAUQQXwKuTZGEJylGu8/xmu3zOZO5cOLlg=; b=HNsflwyIeOsSWRbUD58t36qGlzsC328fRPTLPfJoQtlMqkcpiWyhTv90zpuRY+L+yv iZaIAC/V/022g1VJSnwTXATp8TdCf/FG973TeU+/Feet3z8MB7ZkJW21xhpGM9d82wsH 42h6nnAPqb2ib7t6pAhiMAzl+3qz/2p7D0xfKZO8K+J/CO96SVCuhWT3nxy1nQPYFkmQ m6nuOl3W3pixgE7S+QqIhTgbQndhvqTJKRIpZOLmC53CmNEfQPoARR8BO2XoIjWEl582 53JsaqB5Po//NSCPM/z94iZZpY6WTdhKaxfqB9KPCFpMBb4f3Zr3Z92BBrTicQSbeD7S Ke0Q== X-Gm-Message-State: AOJu0YwEZscPdKer8vo2chdi7MaqG342beHCLXlJbjsc12Dp5MySk/ZB JtkfnRk/bNJTykDZO3NVa6zwOqrAyOKM9xE7YZMp421WXaSb2aX3N0xlKQ== X-Google-Smtp-Source: AGHT+IHq3RNpuqJUO/Lf8JVHRbddMa9G2/ciK060qn2oAC1xm1YALUaRlErVwOvDgvTnYzkHOoVLqQ== X-Received: by 2002:a5d:66c7:0:b0:371:7dda:d7d9 with SMTP id ffacd0b85a97d-3776ee900a2mr2616456f8f.9.1725473142260; Wed, 04 Sep 2024 11:05:42 -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.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Sep 2024 11:05:41 -0700 (PDT) From: Simon Tournier To: 72891@debbugs.gnu.org Subject: [PATCH v2 2/3] doc: contributing: Move up section Teams. Date: Wed, 4 Sep 2024 20:05:33 +0200 Message-ID: <42a35de2d58034700759180b75f29a02ec59dbe8.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 X-Debbugs-Cc: Florian Pelz , Ludovic Courtès , Maxim Cournoyer Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) * doc/contributing.texi (Teams): New section. (Submitting Patches)[Teams]: Move to its own section. Change-Id: I750f6006e49030dd1e9c93b35652da020b72881a --- doc/contributing.texi | 77 ++++++++++++++++++++++--------------------- 1 file changed, 39 insertions(+), 38 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 46d316294a..06edaef77d 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -33,6 +33,7 @@ Contributing * Tracking Bugs and Changes:: Keeping it all organized. * Consensus Decision:: Deciding based on consensus. * Commit Access:: Pushing to the official repository. +* Teams:: Teaming up. * Reviewing the Work of Others:: Some guidelines for sharing reviews. * Updating the Guix Package:: Updating the Guix package definition. * Writing Documentation:: Improving documentation in GNU Guix. @@ -2222,44 +2223,6 @@ Sending a Patch Series another cover letter, e.g. for explaining what's changed since the last revision, and these changes are necessary. -@node Teams -@subsection 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: - -@example -$ ./etc/teams.scm list-teams -id: mentors -name: Mentors -description: A group of mentors who chaperone contributions by newcomers. -members: -+ Christopher Baines -+ Ricardo Wurmus -+ Mathieu Othacehe -+ jgart -+ Ludovic Courtès -@dots{} -@end example - -You can run the following command to have the @code{Mentors} team put in -CC of a patch series: - -@example -$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org \ - --header-cmd='etc/teams.scm cc-mentors-header-cmd' *.patch -@end example - -The appropriate team or teams can also be inferred from the modified -files. For instance, if you want to send the two latest commits of the -current Git repository to review, you can run: - -@example -$ guix shell -D guix -[env]$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org -2 -@end example - @node Tracking Bugs and Changes @section Tracking Bugs and Changes @@ -2904,6 +2867,44 @@ Commit Access you're welcome to use your expertise and commit rights to help other contributors, too! +@node 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: + +@example +$ ./etc/teams.scm list-teams +id: mentors +name: Mentors +description: A group of mentors who chaperone contributions by newcomers. +members: ++ Christopher Baines ++ Ricardo Wurmus ++ Mathieu Othacehe ++ jgart ++ Ludovic Courtès +@dots{} +@end example + +You can run the following command to have the @code{Mentors} team put in +CC of a patch series: + +@example +$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org \ + --header-cmd='etc/teams.scm cc-mentors-header-cmd' *.patch +@end example + +The appropriate team or teams can also be inferred from the modified +files. For instance, if you want to send the two latest commits of the +current Git repository to review, you can run: + +@example +$ guix shell -D guix +[env]$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org -2 +@end example + @node Reviewing the Work of Others @section Reviewing the Work of Others -- 2.45.2 From debbugs-submit-bounces@debbugs.gnu.org Wed Sep 04 14:07:56 2024 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 To: 72891@debbugs.gnu.org Subject: [PATCH v2 3/3] doc: Define the purpose, membership, and creation of teams. 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 X-Debbugs-Cc: Florian Pelz , Ludovic Courtès , Maxim Cournoyer Content-Transfer-Encoding: 8bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) * 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 From debbugs-submit-bounces@debbugs.gnu.org Thu Sep 05 05:17:28 2024 Received: (at 72891) by debbugs.gnu.org; 5 Sep 2024 09:17:28 +0000 Received: from localhost ([127.0.0.1]:36150 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm8cK-00075W-6G for submit@debbugs.gnu.org; Thu, 05 Sep 2024 05:17:28 -0400 Received: from relay.yourmailgateway.de ([46.38.247.119]:48881) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm8cH-00075K-Si for 72891@debbugs.gnu.org; Thu, 05 Sep 2024 05:17:27 -0400 Received: from mors-relay-8404.netcup.net (localhost [127.0.0.1]) by mors-relay-8404.netcup.net (Postfix) with ESMTPS id 4WztyW5zMDz81Vs; Thu, 5 Sep 2024 11:16:19 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1725527779; bh=MLzeSM+Yq4oHhNHooZNBGZY35/ukbH+Pk9T/qLNDRCg=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=e1iRqCrVH+ol7FvJtzvripefFThe99IC/XZc4cvPToxhtjJjVqRsMmIzpD+99PuK5 cyIDfWw7i2HOCF5UDi0WHABMJAar0bgvRq71tPVZRoNgCJiGrhJgPKhCr7TzK2JdD0 Li3nX266kscI4oS9XSexLu7/u1q4aVDGYS/0xQJ++jaHOEWoMC5bivjZhm248F66Hg 5TfY1X0esLGzgDxCYQg0PRUHCQxWr2qwLmhj6w08hJ2/83uA49EVHyc9s+dSKJdE+v PTRWeSRM4s+f/QkggUJuteoI5N4eC5cJjFoRnETOe9q20DzXMd+f6xxMHWa2nnppXo j6Pz/tZQyLVHg== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-8404.netcup.net (Postfix) with ESMTPS id 4WztyW5bbvz4xvW; Thu, 5 Sep 2024 11:16:19 +0200 (CEST) Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy02-mors.netcup.net (Postfix) with ESMTPS id 4WztyW44RSz8svG; Thu, 5 Sep 2024 11:16:19 +0200 (CEST) Received: from florianhp (ipb2186896.dynamic.kabel-deutschland.de [178.24.104.150]) by mxe217.netcup.net (Postfix) with ESMTPSA id 04B2F839EB; Thu, 5 Sep 2024 11:16:11 +0200 (CEST) From: "pelzflorian (Florian Pelz)" To: Simon Tournier Subject: Re: [bug#72891] [PATCH v2 3/3] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <85a6c932a8d4b742f66d1469be21c448b1e34526.1725472527.git.zimon.toutoune@gmail.com> (Simon Tournier's message of "Wed, 4 Sep 2024 20:05:34 +0200") References: <4c46c09e486681f749d837e9c8cac7f5309436ce.1725472527.git.zimon.toutoune@gmail.com> <85a6c932a8d4b742f66d1469be21c448b1e34526.1725472527.git.zimon.toutoune@gmail.com> Date: Thu, 05 Sep 2024 11:16:11 +0200 Message-ID: <87seueh350.fsf@pelzflorian.de> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 04B2F839EB X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: GcQv4lIH6XDQ1sfvZIek6ucPKTdfoRiKh6mfWKstH1YL3H4Xj2Hs7H5/ X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= , 72891@debbugs.gnu.org, Maxim Cournoyer X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi! I agree with such additions; just some comments: Patch v2 1/3: Simon Tournier writes: > * doc/contributing.texi (Consensus Decision): New section. > Ccommit Access): Move consensus decision to its section. =E2=80=9CConsensus Decision=E2=80=9D is a single act of deciding. I guess lengthy =E2=80=9CConsensus Decision Making=E2=80=9D is the best section title. In the commit message, you wrote C instead of an opening parenthesis. Patch v2 3/3: Simon Tournier writes: > +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}). =E2=80=9COther said=E2=80=9D is close to a term we use in German, but in En= glish better say something from . Regards, Florian From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 09 04:59:01 2024 Received: (at 72891) by debbugs.gnu.org; 9 Sep 2024 08:59:01 +0000 Received: from localhost ([127.0.0.1]:60637 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snaEf-00089s-07 for submit@debbugs.gnu.org; Mon, 09 Sep 2024 04:59:01 -0400 Received: from eggs.gnu.org ([209.51.188.92]:40642) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snaEd-00089f-A7 for 72891@debbugs.gnu.org; Mon, 09 Sep 2024 04:58:59 -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 1snaEU-0002Gi-89; Mon, 09 Sep 2024 04:58:50 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=BhpjvMrOno4j3GreLGSS9TdzI54d8drIfdq+2FRnggA=; b=J5inorL99pjnWOl5Z3RQ vHokJZ4zZS1BVnwTzG9s+KrmXYqmkndr0NIFDogIkx0FFULQNpYcMRk7jlKkS7wgGob6++vVy+Wsm UhIWOoCJqqn7fdzmmc9kfY2v/mBdqwmBq/WZ+MZ5vt7Ysooqtq8Y9MnSiqm733c48JxSK5NX+ibbJ nSCWlPnxLETT5XDVwGJSj0CSP9GAxuW3xehsEljK/IuYNbzKqNhwvVVrWHR5pULzSAmHvqjxAD6dO jd8vKC/8I9/HUW1P9Y75wYkUH3nbJc0gmeTFljwoWEJrkJ75KFXXHuL7FPDvnd9XFLH/QYqXrpd8s b/n5REE1LqWGyA==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Simon Tournier Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <87plpjwcrm.fsf@gmail.com> (Simon Tournier's message of "Wed, 04 Sep 2024 19:26:53 +0200") References: <87plpjwcrm.fsf@gmail.com> Date: Mon, 09 Sep 2024 10:58:46 +0200 Message-ID: <87o74xciex.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org, Florian Pelz , Maxim Cournoyer X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hi Simon, Simon Tournier skribis: > On Fri, 30 Aug 2024 at 12:12, Ludovic Court=C3=A8s wrote: [...] >> +@c TODO: Currently ``consensus-based decision making'' is discussed >> +@c under ``Commit Access''. Move that elsewhere and refer to it from >> +@c here. > > If we are at it. I think this =E2=80=9Csection Teams=E2=80=9D should be = moved to its > own section and not a subsection of =E2=80=9CSubmitting Patches=E2=80=9D. > > The =E2=80=9Cconsensus=E2=80=9D should also move to its own section. Yes, I agree (I wanted to minimize changes here so we can focus on just this one thing). > See v2 for a proposal. Nice! >> +As an example, the Python team is responsible for core Python packaging > > [...] > >> +To list existing teams, run the following command from a Guix checkout: > > What is missing between the brackets [...] is a link to =E2=80=9CReviewin= g the > work of others=E2=80=9D. Somehow, I would add a sentence clarifying =E2= =80=9Cits work=E2=80=9D. > For instance, I propose a last sentence in the paragraph: > > As an example, the Python team is responsible for core Python packaging > > [...] > > the entire community. Other said, teams provide feedback on patches > touching its scope (@pxref{Reviewing the Work of Others}). The first paragraph reads: 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, [=E2=80=A6] I don=E2=80=99t think that needs repeating. The second paragraph is a list= of examples of what the first paragraph describes. Thanks, Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 09 15:06:17 2024 Received: (at 72891) by debbugs.gnu.org; 9 Sep 2024 19:06:17 +0000 Received: from localhost ([127.0.0.1]:34191 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snjiL-0007Cw-4N for submit@debbugs.gnu.org; Mon, 09 Sep 2024 15:06:17 -0400 Received: from mail-wr1-f52.google.com ([209.85.221.52]:61933) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snjiJ-0007Cb-Fj for 72891@debbugs.gnu.org; Mon, 09 Sep 2024 15:06:16 -0400 Received: by mail-wr1-f52.google.com with SMTP id ffacd0b85a97d-374ba78f192so2795817f8f.3 for <72891@debbugs.gnu.org>; Mon, 09 Sep 2024 12:06:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725908705; x=1726513505; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=gbndkQyF4BCT54LQoqngcmTLLl1gWTSyomZ0rX13hlY=; b=NNZZeqOkNKTN/cYx3y1X9EBLUbhw5ymVBu7uKVo8eY7BtgpbCjiwK+zbLMY6eLKb4y 5jZzus4A6eGX6DWnvkFtTA0UnR5qWe7SaXr4o63joU+c54Ss62u4nT8UrEPnjQa4pR2T iTznHbwhCFWdCRzcidALTfDl8faz+ZNlnBevR6YHd9fOIbeIa5OArPVReiQ+dO71PAj3 sIxPi0BCN6SBnuuwPSCzWYZuuGZtXbfdQazdtaXn9C29iX590OWDv8j4apSjuc7kXD+j MTdchjJiZfdXRYmCxh3rbi1UBwOK+KRAL7mwSZSxb8CzkAhJLuuBMg36nWuNsSY0LdAL ww2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725908705; x=1726513505; h=content-transfer-encoding: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=gbndkQyF4BCT54LQoqngcmTLLl1gWTSyomZ0rX13hlY=; b=hskNlu64tM6wuttVFkmP/M0AoZIF3GGXONNTtc5ZR0vL2pbN3WKxjjiO+cuPaI81tx q1fqGM6Csvja/q81qqgeocdXPwajzCmTKNLUUwAulA5vjKQMYoPc3edzE2WbAQGQZMJt Q8ydW61zgA6urlS75o3cLQLeXNGjH/BMC+FmMyglFpoGd2eFmPwnWIp/Z7E2VyFwSBQj 4C0IppmojuF6Qb95RGOJKW2Rhj5rGdGEGVsyMpR54lIRNy35tQaMS2BQixKgPbiYc7kC GPK/L/Mg7t+PEXgnt7yxfVU0enWIeCTq2xmVypfc/3Sazsf+Hv90BYyJM9c25DnQcwVt baxQ== X-Gm-Message-State: AOJu0YzjMmipPMszHKauTeoXK/hA5E7Dt6/RmQO/NSUdbnw7Odv4/5XX grN6zUGeWK7BRClCUu3liaIE9BiPCB2FaUJBUF8TKqi772cy4REY X-Google-Smtp-Source: AGHT+IFUOF1qNdJ/tCaa4V4m8YTmiEvYzDf/SIamOUwSNB8B2fK4zEwcv8A65yhgfkNsQHEnKky3Mw== X-Received: by 2002:a5d:4b84:0:b0:374:c69c:2273 with SMTP id ffacd0b85a97d-378896591e7mr6961559f8f.37.1725908705116; Mon, 09 Sep 2024 12:05:05 -0700 (PDT) Received: from lili (roam-nat-fw-prg-194-254-61-40.net.univ-paris-diderot.fr. [194.254.61.40]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-378956d3738sm6714444f8f.69.2024.09.09.12.05.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Sep 2024 12:05:04 -0700 (PDT) From: Simon Tournier To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: [bug#72891] [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <87o74xciex.fsf_-_@gnu.org> References: <87plpjwcrm.fsf@gmail.com> <87o74xciex.fsf_-_@gnu.org> Date: Mon, 09 Sep 2024 19:48:24 +0200 Message-ID: <8734m8sopj.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org, Florian Pelz , Maxim Cournoyer X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Ludo, On Mon, 09 Sep 2024 at 10:58, Ludovic Court=C3=A8s wrote: > I don=E2=80=99t think that needs repeating. The second paragraph is a li= st of > examples of what the first paragraph describes. Well, it was my feedback when reading. :-) LGTM. Feel free to use v2 or not. Let me know if you don=E2=80=99t and I = will resend the split to another patch submission. Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 09 20:21:40 2024 Received: (at 72891) by debbugs.gnu.org; 10 Sep 2024 00:21:40 +0000 Received: from localhost ([127.0.0.1]:34397 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snodY-00061i-6k for submit@debbugs.gnu.org; Mon, 09 Sep 2024 20:21:40 -0400 Received: from mail-pl1-f180.google.com ([209.85.214.180]:45062) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snodV-00061U-E2 for 72891@debbugs.gnu.org; Mon, 09 Sep 2024 20:21:38 -0400 Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-2068bee21d8so48463515ad.2 for <72891@debbugs.gnu.org>; Mon, 09 Sep 2024 17:21:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725927627; x=1726532427; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=fpoXon3md0HTNQ5PJvLPK2f1cDCIgU8mg4VR6d11WHA=; b=Bnlk4ILHa03Chr73ND6TCWDYmaa0xOh2I7NdCT1hcbqP6OukKQ3VikLO/Yd9n8Xdc7 CkMnxFsr+A78YBj1qmIfKyIkRV+E5XrNXwM9IcQ1nUrGu+aQekQi3xGKBYpBVdIMNLwt GpjABxWQYnROXssgYGjG6XNf3ZeD9hKbbRb/m1gqjqRjOGebhK/s0PnQ6jrVC3EnQOfY 8Ratzr5EnAbuDWucWrjQ5dFOjzFBW7Xi/j3auugjeg7re6a4jKu7gps1LiB5m0NA9qOs RhGncITFvdGbpeLdkfe+yYVRDFi15F2Crhfjqgvc8P6WPjIhum6NFl/fjNHoBiJKDvtj AqmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725927627; x=1726532427; h=content-transfer-encoding:mime-version:user-agent: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=fpoXon3md0HTNQ5PJvLPK2f1cDCIgU8mg4VR6d11WHA=; b=CJvq3lBFowT0+DYbsgpy0gUGnqevP0iG+ciyp0MRqOlUvFnzqqVyNSWFajC2TLrhUI gyvsI3gPhZUBy1tH7kF/4QKVN5l8RGL86gmJPOpGvgv88fj/EXt+bBxWVM2CtDZEPqzZ NQJCpZtSZ/hGZhXLmcKUyY12SFPKRh0rfHyY/j6HO3vUM3U+NgUgeW4oZMnPeAM/3MEP Ffob2gRiL2EisaYMSU6PvG6JChC7Tjym1bPdWBMNrmzpLkSpkVLz/MF9OGEc4Fh/BfDW XKGoqxL9Qxx/ltsHZogag43T9ubYsP08+3MKFE8ZZGdtStQETgF1nV14ORARPPOodKwR Uieg== X-Forwarded-Encrypted: i=1; AJvYcCV+u4gygEX25GjM1uVOvkv0vBr5UPrKVKjAVT+jYAcG7xO2eQJn8CQ/ht0kiVRSOmvR/4EjGw==@debbugs.gnu.org X-Gm-Message-State: AOJu0Yzls3sDWFyqOwWeJzJteUVMkmR2jn4ktkt9/Rxk/L1BZYRY/FcQ e/uitByVgwdcZzl9sM4IfpbmF0gaINmMtFZ6izn8egqor7h6wDNO X-Google-Smtp-Source: AGHT+IF0CLCfdiWJ/M+4De3C6aE4x3wy6R/87nfAd9rANE1WKY1+hACYEVpGtGTW3GOulxFArlC8rA== X-Received: by 2002:a17:903:8ce:b0:207:2093:99a3 with SMTP id d9443c01a7336-20720939ac8mr92487825ad.5.1725927626508; Mon, 09 Sep 2024 17:20:26 -0700 (PDT) Received: from hurd ([2405:6586:be0:0:c8ff:1707:9b9:af89]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-20710e3271csm38854285ad.78.2024.09.09.17.20.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Sep 2024 17:20:25 -0700 (PDT) From: Maxim Cournoyer To: "pelzflorian (Florian Pelz)" Subject: Re: [bug#72891] [PATCH v2 3/3] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <87seueh350.fsf@pelzflorian.de> (pelzflorian@pelzflorian.de's message of "Thu, 05 Sep 2024 11:16:11 +0200") References: <4c46c09e486681f749d837e9c8cac7f5309436ce.1725472527.git.zimon.toutoune@gmail.com> <85a6c932a8d4b742f66d1469be21c448b1e34526.1725472527.git.zimon.toutoune@gmail.com> <87seueh350.fsf@pelzflorian.de> Date: Tue, 10 Sep 2024 09:20:21 +0900 Message-ID: <87y140741m.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= , 72891@debbugs.gnu.org, Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, "pelzflorian (Florian Pelz)" writes: > Hi! I agree with such additions; just some comments: > > Patch v2 1/3: > > Simon Tournier writes: >> * doc/contributing.texi (Consensus Decision): New section. >> Ccommit Access): Move consensus decision to its section. > > =E2=80=9CConsensus Decision=E2=80=9D is a single act of deciding. > I guess lengthy =E2=80=9CConsensus Decision Making=E2=80=9D is the best > section title. > > In the commit message, you wrote C instead of an opening parenthesis. > > > Patch v2 3/3: > > Simon Tournier writes: >> +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}). > > =E2=80=9COther said=E2=80=9D is close to a term we use in German, but in = English better > say something > from . I agree that "Other said" doesn't sound too natural in English (in the sense that I've never heard it from native speakers -- disclaimer: I'm not one). I believe Simon borrowed it from "autrement dit", which is good French :-). --=20 Thanks, Maxim From debbugs-submit-bounces@debbugs.gnu.org Mon Sep 09 20:23:14 2024 Received: (at 72891) by debbugs.gnu.org; 10 Sep 2024 00:23:14 +0000 Received: from localhost ([127.0.0.1]:34401 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snof3-00064U-Ns for submit@debbugs.gnu.org; Mon, 09 Sep 2024 20:23:14 -0400 Received: from mail-pl1-f170.google.com ([209.85.214.170]:60873) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snof2-00064I-GK for 72891@debbugs.gnu.org; Mon, 09 Sep 2024 20:23:12 -0400 Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-2054feabfc3so43723935ad.1 for <72891@debbugs.gnu.org>; Mon, 09 Sep 2024 17:23:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725927722; x=1726532522; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=+8XVse//j6UEn9DxXOv27e8Av269rHZ05pQ2spM8wKU=; b=NYH4ptsAfubPY8BFqfmRdTzxoWf2HV6bOJtAS+WJwB9oyGHnnDieza1WAh4wesQJ+H Ccl3EIzSJDrZGDUjuwERnumrbnqKK5HktGbF0XVJfjmkSPmTh9TqpFBPHaMhe6UCM1By cErtVkLel8wHwpZP8LOJV7wNfH+uwIjBIp+2L3rfbp0oBtA2e3J76HS1+Ugc8OoNhkJX AK4Uc8prtOttPw8JxCda20VtqKj2buQsbdSSiOqReD1vu+IqENWRUzBFV7vc8U0bVTYz xc9SCGyM3Isk0tHUBl0fgXwQnirWiErfoMw4sB3BeA5toN3o6oSwUMFi91R0K/1ONIFI HGwA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725927722; x=1726532522; h=content-transfer-encoding:mime-version:user-agent: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=+8XVse//j6UEn9DxXOv27e8Av269rHZ05pQ2spM8wKU=; b=Wcq75StKNGRuVLz6SXfDf2fJFjZ2SizfaYkz21SfO3P9RbutqUaBXWBGSOp3qVS/tk 3dScSF1y/Dda8DbnT6g2bxKjKzoUHnC6UedrCBfpe8U6fLuXQvNwYe0X0Cnd8in/02sI Ffmtr4779W8elLhhMdmh8j5JcNdxc2piN4sZUPkQCXXifSOvj1E8Wi7W9k+lVsWrnn7t B0P8uGaUNchpVqdYGlyJG/L2M5oSphfk0EflLEzh5KKHDrCqXg5A5eKdcMNJoQFXUiiM DIDK5IwcOjweABkH/QxvnmobzANuj+2izSKxJBA31j0EOuxPF6jV4c2mW6miMtdXd1eS 3Evw== X-Gm-Message-State: AOJu0YzzNqFOgQ+JoTJi57civWfjF5ycwbxnBPzxCFlOiAMNnXx8qRSU eQxxlY/QFuzz6jVDNPKV8yJZ6XOp9JvbJbxR1hOYsLDAU1xmpgwy5TPHGw== X-Google-Smtp-Source: AGHT+IFH+/WdfT3wnt+hd2pVMtAmhvnH7jRATw6d5K6CIwQYLdKR21V8xr6s7MzT8g3Ys60Cmdwmrw== X-Received: by 2002:a17:902:f788:b0:205:56e8:4a4b with SMTP id d9443c01a7336-206f04e1a86mr181811985ad.2.1725927722342; Mon, 09 Sep 2024 17:22:02 -0700 (PDT) Received: from hurd ([2405:6586:be0:0:c8ff:1707:9b9:af89]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-20710f221f2sm38595225ad.218.2024.09.09.17.22.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Sep 2024 17:22:01 -0700 (PDT) From: Maxim Cournoyer To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: [bug#72891] [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: ("Ludovic =?utf-8?Q?Court=C3=A8s=22's?= message of "Fri, 30 Aug 2024 12:12:04 +0200") References: Date: Tue, 10 Sep 2024 09:21:58 +0900 Message-ID: <87tteo73yx.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org, Florian Pelz X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello! Ludovic Court=C3=A8s writes: > * doc/contributing.texi (Teams): Define the purpose of teams; provide > example; clarify membership and team creation. > (Reviewing the Work of Others): Link to =E2=80=9CTeams=E2=80=9D. > > Change-Id: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d Reviewed-by: Maxim Cournoyer Thanks for authoring it. I think the first two v2 patches of moving things around by Simon would make sense as a follow-up, although I haven't verified the result. --=20 Maxim From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 14 08:40:28 2024 Received: (at 72891-done) by debbugs.gnu.org; 14 Oct 2024 12:40:28 +0000 Received: from localhost ([127.0.0.1]:37042 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0KN6-0008QK-Cv for submit@debbugs.gnu.org; Mon, 14 Oct 2024 08:40:28 -0400 Received: from eggs.gnu.org ([209.51.188.92]:38226) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0KCa-0007fM-DR for 72891-done@debbugs.gnu.org; Mon, 14 Oct 2024 08:29:33 -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 1t0JyQ-0000iI-Pz; Mon, 14 Oct 2024 08:14:54 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=YicS7jkMwSnPoPhP7r94WEWSKJs6xwThqxZjCQSEzDc=; b=Ev2t2AsVoRtTKXSiB+Ww /XQuqHWF8ZdEdwcZ/AOnpM+6xy66mTpYPQhH+KM/C/K5Sy0Mq6je6ZktCfBvekLX119wViB0/8KEx yYPMGdjm4na2/W6g8ZKGM6kxewLqMtN0Pir6dSBtb37YT0rU9aHw4lTti9NYIiegZXoeFxt9tFEjy 7cMKPVwyHKWnNiKnEkBFrr9tD2umFi/6U9EPdKo6dfrVHuPIQkrag9W9WdH4m09bchBrHbJXITkRW TUQFUkugTG94GZyx3uKFpAlkXcVwG0oATHgUHtWrPE6mst/YxIDH8NtJkWBDkB6Oauem0yb+96zCV hREUO80aPQdSFw==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Maxim Cournoyer Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <87tteo73yx.fsf@gmail.com> (Maxim Cournoyer's message of "Tue, 10 Sep 2024 09:21:58 +0900") References: <87tteo73yx.fsf@gmail.com> Date: Mon, 14 Oct 2024 14:14:50 +0200 Message-ID: <87jzea285h.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 72891-done Cc: 72891-done@debbugs.gnu.org, Florian Pelz , Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hello, Maxim Cournoyer skribis: > Ludovic Court=C3=A8s writes: > >> * doc/contributing.texi (Teams): Define the purpose of teams; provide >> example; clarify membership and team creation. >> (Reviewing the Work of Others): Link to =E2=80=9CTeams=E2=80=9D. >> >> Change-Id: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d > > Reviewed-by: Maxim Cournoyer > > Thanks for authoring it. I think the first two v2 patches of moving > things around by Simon would make sense as a follow-up, although I > haven't verified the result. Pushed as 6757bfdfc0b22a1e23a3d33566155550182244fc. If nobody beats me at it, I=E2=80=99ll follow up with patches to move the b= its about decision-making in a section of their own, along the lines of what Simon proposed. Thanks everyone, Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 14 13:37:56 2024 Received: (at 72891) by debbugs.gnu.org; 14 Oct 2024 17:37:56 +0000 Received: from localhost ([127.0.0.1]:43598 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0P11-0003yZ-Ej for submit@debbugs.gnu.org; Mon, 14 Oct 2024 13:37:56 -0400 Received: from eggs.gnu.org ([209.51.188.92]:47282) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t0P10-0003y7-F1 for 72891@debbugs.gnu.org; Mon, 14 Oct 2024 13:37:54 -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 1t0P0d-0000EP-MW; Mon, 14 Oct 2024 13:37:31 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=lKNZLaeop2dB/G8pK7pgYjLySQnwWnGHU4QfiHMgZy8=; b=Tktc85ctxO0XiMEu+13+ Mk4VEx6akUQ76ler5TaT5zZSi3Bm/MNCzYcmaV9pTPJoY+3bjPp5bG722+yAmUEKFZTjzQTsllpFG UDvHoa7ssrPNVoCG1pTPmXwgcZEujWjNgfNC84IqGJExoW8+qLRrcmt7oCod+IkYNJlNDwD068Ddk sBhkTHnQSQo/9jYDbdXbT6is0shruTNJLLLsazmot2+04oAe+tSAUc/kz8hyWETTTgOnCmG6kHd8O DBRL031jbzPSzOWqESHU+gWCWWmUOQDsN+0nQbMYOpsS5BJ4oeEFPj+QE1xx/k7dDM0Dmm68CMpIo m6tb5iW4HygXZA==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Maxim Cournoyer Subject: Re: bug#72891: [PATCH RFC] doc: Define the purpose, membership, and creation of teams. In-Reply-To: <87tteo73yx.fsf@gmail.com> (Maxim Cournoyer's message of "Tue, 10 Sep 2024 09:21:58 +0900") References: <87tteo73yx.fsf@gmail.com> Date: Mon, 14 Oct 2024 19:37:28 +0200 Message-ID: <877caa1t7r.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 72891 Cc: 72891@debbugs.gnu.org, Florian Pelz , Simon Tournier X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Maxim Cournoyer skribis: > Thanks for authoring it. I think the first two v2 patches of moving > things around by Simon would make sense as a follow-up, although I > haven't verified the result. I=E2=80=99ve now sent followup patches similar to what Simon suggested: https://issues.guix.gnu.org/73803 Ludo=E2=80=99. From unknown Sun Aug 17 00:59:11 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Tue, 12 Nov 2024 12:24:17 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator