From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id wK+kE9+h2GYNkwAAqHPOHw:P1 (envelope-from ) for ; Wed, 04 Sep 2024 18:07:27 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id wK+kE9+h2GYNkwAAqHPOHw (envelope-from ) for ; Wed, 04 Sep 2024 20:07:27 +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=HkoIcMEQ; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=PWJFEUol; 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"; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1725473247; 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=fTih648E5bAUQQXwKuTZGEJylGu8/xmu3zOZO5cOLlg=; b=Gu0HDGSA6q88MdGyr0/TscS/I5oaTRUYpBHpuLnEQ0Z4u1rLee/gHN3h++pnF/sWXIiEOq SfsJD7k1J4hQrevQzT8ljFU81XUOG82ew8QOVv/QS18Fe9PEaWgicUEfk/mpHcPibLxbep m2ygLQ7RV1C2ee/5dCcJAbCkfuUDcVSU9KC0vv+QoBowzRw03hmYoLGyfrES3jsJ7BtZaD fGRVDGFwjfRhuFYpqTqgz6Z8Ak/yMDYaGcOccwQUXMp/nw/xx1OGV+tkEIQ7lwUQKHWtLX 09M+KHrxLZ7bMFqlFPzhu44Tweb5xDwf9Oynwj3gBmw0rgc9MWgSYB8f1ejouQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=HkoIcMEQ; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=PWJFEUol; 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"; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Seal: i=1; s=key1; d=yhetil.org; t=1725473247; a=rsa-sha256; cv=none; b=VlT8B3q6rhKMCZgTWkkGxNNCQ60PFgWJ2j3pcv0lFdBKWGr/0IT2uUqEC2XAFmOjsF+dYa 2jD17Mxoco1zf96PzI5h1A4SBKpl2iWhiFPT+VoeSrCA0nXH5lxp/gu2Bpx3p+LcFD2VhH baCDybrVnbOGBUnILnislSpaV+wSCwlq25y8sJYFX7e383TujQAl+P4SqvzY6DMGN0eRD+ Ft9UFxhA8y/YEBfVt+gPZiDIWEB23ER9bUHbfjQzyq6MIBdmSGwuA6Ctg7EWdd6qWDEYuQ vm4m3R+IQggN60u0iXsbnfYsw7I8la5RT3bn4dQC58FR4aLVSEy0I+Vf5x8FUg== 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 24CCF12FB2 for ; Wed, 4 Sep 2024 20:07:27 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sluPS-0004iG-4Z; Wed, 04 Sep 2024 14:07:14 -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-0004h5-KQ 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 1sluPF-00089K-0k; 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=fTih648E5bAUQQXwKuTZGEJylGu8/xmu3zOZO5cOLlg=; b=HkoIcMEQLYrK1gSWyNVU/RGVWMsJ1JoiES8iGOuWth8kqrvRb+PuAur/jOvCD06zUROiQ2vmvTGk4kGCTezKEzL7lfpixqMq9PyoCptTCg5KWGw0jB/mMTYpjXT1Q1MWsXtqZYiDQ6wodC7Sw7caXtmW1l6wnmx3o/JJWshxRyeB9WwbN4ocR68uvkMujna3Vfl4UomiUyoDUyWaPL5tiW7yx29m39jlUaXY6YHgUQgjf540/2iiuxaGWo3gKTPnzMYiis8RHNOkBKmxsq5GwN5pgRIInypQqPbu9IWLj59fCiB/QJDcwMw2CnPQz2MZe6q0bIDnLC7ycFeJLblnhg==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sluQE-00019l-Rr; Wed, 04 Sep 2024 14:08:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72891] [PATCH v2 2/3] doc: contributing: Move up section 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:02 +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.17254732744417 (code B ref 72891); Wed, 04 Sep 2024 18:08:02 +0000 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 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 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-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Queue-Id: 24CCF12FB2 X-Migadu-Scanner: mx13.migadu.com X-Migadu-Spam-Score: -8.92 X-Spam-Score: -8.92 X-TUID: Wa1oV2c1kPZA * 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