From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id gFBnGC6h0mDikgAAgWs5BA (envelope-from ) for ; Wed, 23 Jun 2021 04:49:18 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id IGACFC6h0mD2JQAAbx9fmQ (envelope-from ) for ; Wed, 23 Jun 2021 02:49:18 +0000 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 8FE749F55 for ; Wed, 23 Jun 2021 04:49:17 +0200 (CEST) Received: from localhost ([::1]:58762 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lvsx2-0004iK-Dr for larch@yhetil.org; Tue, 22 Jun 2021 22:49:16 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55022) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lvswr-0004i7-Hc for guix-devel@gnu.org; Tue, 22 Jun 2021 22:49:05 -0400 Received: from mail-pj1-x1034.google.com ([2607:f8b0:4864:20::1034]:35798) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lvswo-0001lb-R9; Tue, 22 Jun 2021 22:49:05 -0400 Received: by mail-pj1-x1034.google.com with SMTP id pf4-20020a17090b1d84b029016f6699c3f2so3007958pjb.0; Tue, 22 Jun 2021 19:49:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=uvFo3nDPZPvLKquTOkMB18tKmV/TJe3Pypp/2xStO/Y=; b=Fuz/hDcwxwsFlqhYue5WVL5XXwisaPvdDQoUBDA6XSWYSduCTp4OVPr+zTChBglexx U5BhjUZSGn80hluavwzIY62ckItYrlCjcDxTFbVtlsLW8KxCO3pw2zfMDfqZtl9UUobF afSRQgL0x3xhA1M7vDvGFR+lZ2aDOcPhaqtHF7EWjul4W/swOH7Lt78Y4xH/WMpeGgME ig24NIKPl4Sbgp0tfmOw0C59SwIHNx3ClgtLjNXuQS27fUwptG9lKhvtYwuJV22dmhQS 66xH20ZzLPrwCy9gxAaayfqI38O8mXo2LbC6Xri70wlrBN1auq+ZeZL7COGRzbMFnlc7 w7Lg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=uvFo3nDPZPvLKquTOkMB18tKmV/TJe3Pypp/2xStO/Y=; b=uc+jnIsRLKnNshrujQGtMJYdWU3dnaj4bNvXOZh9KjCVHM7U44UNvS+hpIR889OYdG 7xTBpzU92AcwSUi/L5IuT8Ey2Kz2o/Lya5ZIGLoF7XMhfu0tWDSWO0oyiit53IqV7eLl UxWK0JJYbEgW3pEYybil+ascxSexgB7l57F+0HkKPz87Mr1JYAiuSQcluJd+7mxjOyl3 A3ClMuZNR/xJL/H/cfV5vv+yl62vOfmLUQHRhpD8N2GYpXgouH5/lFk6C703jx5QiBGN 0pc/2Z8xwgguCr7356CaFT03Yp9AXsT9lI1gIxcQ2zaDnTCa2yX1jHvwMwjVWz0rEW1r j8Og== X-Gm-Message-State: AOAM5332bxHC9i0YfWmW6eLHBMx5NxKWOPZq/3AiyPNOFwrpSTjchVae 8boPAty84py30qAcoLL2S4Uz9HCvY8YI2Q== X-Google-Smtp-Source: ABdhPJyzHCAWJnj+nU9NkwaBnvFX9wUvz1fMKM2FYfm/38/ixnzFxDTyvtucMvr3AZ+hl8THqtek9g== X-Received: by 2002:a17:902:f282:b029:124:701f:2fe7 with SMTP id k2-20020a170902f282b0290124701f2fe7mr13231389plc.10.1624416540818; Tue, 22 Jun 2021 19:49:00 -0700 (PDT) Received: from garuda-lan ([2601:601:9d01:3f90::b00d]) by smtp.gmail.com with ESMTPSA id e4sm589928pfa.29.2021.06.22.19.48.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 22 Jun 2021 19:49:00 -0700 (PDT) From: Chris Marusich To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: Debbugs user tags References: <87eeec8nfc.fsf@gmail.com> <87v97khrse.fsf@gnu.org> <87tun2om0a.fsf_-_@gmail.com> <87im2edzb1.fsf@gmail.com> <878s34cxj3.fsf_-_@gnu.org> Date: Tue, 22 Jun 2021 19:48:58 -0700 In-Reply-To: <878s34cxj3.fsf_-_@gnu.org> ("Ludovic =?utf-8?Q?Court=C3=A8s?= =?utf-8?Q?=22's?= message of "Sun, 20 Jun 2021 18:26:40 +0200") Message-ID: <871r8tb8it.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Received-SPF: pass client-ip=2607:f8b0:4864:20::1034; envelope-from=cmmarusich@gmail.com; helo=mail-pj1-x1034.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: guix-devel , Maxim Cournoyer Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1624416558; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=uvFo3nDPZPvLKquTOkMB18tKmV/TJe3Pypp/2xStO/Y=; b=drCcb/RGZoruUwz7ArlkjRS5AdT+0vwxzKSU54CpPB5k0HIbJOHSv73flR1UESMMCCGcU1 85mfY1A+gOY5xIXVDWDZ8rN+VOScmEnISi72mvbnbe4E+jmnrpx9x6AtHpCB6pjxz4GMqe lceHQC/dYcRfPhclhJxZgridSDUXb3rpKIL1JFPwcZLj1gxZRa2LKwPsrNjNps6KAjI1j0 Au3FfTyjaVlVcWiGraZvYfijnkJF8Dds5x+YlyKbIqViXbf3Kf7VE8tY8xrp5EzNdhbNGc UGGhdOwpwLJ1nJCYajYz9mRa3Ua4CQhMAyPCScgD0b9WQjHQL4AnzSHsYO7vaA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1624416558; a=rsa-sha256; cv=none; b=PfkWLkfxTkD1u9MTVBTWjRdC0mhD8O2xKq3+9WDxG3WI3N9UNOWFzENKttZARgNld/aIfd sqcYaEukNevuoYUt6uoF6Gnk1GnJzf8F1dAzFTRNfDKZtVrwUMUYzZIDskoEowGVRe5SRR Va+0R+QLskVWPQ571392OlRtDeYWMdn5YIwTxwvsZOoZJcYH8bHIQjmYVkkn2ndJTikSLZ l69WkbiLlGMNNlgCPsrLRfuWHgj7z3veVUkGXbSuMsNdJeC9P9JYGDtW0MSGKnPCZL+eCQ Dvg4wjmpZiIgqvINHtto+i2Ju7MWlsMryWC1YsUoylg8kJtVZ8hua01Jxouixg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b="Fuz/hDcw"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Spam-Score: -1.92 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b="Fuz/hDcw"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Queue-Id: 8FE749F55 X-Spam-Score: -1.92 X-Migadu-Scanner: scn1.migadu.com X-TUID: ApLUBL5MOEAn --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Ludovic Court=C3=A8s writes: >> Anyone who wants to help with powerpc64le-linux is, of course, more than >> welcome to coordinate and lend a hand! I will be tagging bug reports >> specific to powerpc64le-linux with the "powerpc64le-linux" usertag, for >> the user "guix-devel@gnu.org". You can see the open bugs tagged thusly >> here: >> >> https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=3Dpowerpc64le-linux;us= ers=3Dguix-devel@gnu.org >> >> For details on usertags, start here: >> >> https://lwn.net/Articles/150658/ > > Should we add some text (and conventions?) to =E2=80=9CTracking Bugs and > Patches=E2=80=9D in the manual about usertags? Sounds like it could be u= seful. How's this? =2D-=20 Chris --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Document-the-use-of-Debbugs-usertags.patch Content-Transfer-Encoding: quoted-printable From=20f640132745b26b19bd163bc67482e8aea041881b Mon Sep 17 00:00:00 2001 From: Chris Marusich Date: Tue, 22 Jun 2021 19:44:18 -0700 Subject: [PATCH] Document the use of Debbugs usertags. * doc/contributing.texi (Contributing): Update the short description of the "Tracking Bugs and Patches" chapter in the menu. (Tracking Bugs and Patches): Split this section into three new subsections, titled "Debbugs", "Debbugs User Interfaces", and "Debbugs Usertags". Of these, only the "Debbugs Usertags" is actually new. =2D-- doc/contributing.texi | 61 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index e612ea7b23..6a287fe6a4 100644 =2D-- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -26,7 +26,7 @@ choice. * Packaging Guidelines:: Growing the distribution. * Coding Style:: Hygiene of the contributor. * Submitting Patches:: Share your work. =2D* Tracking Bugs and Patches:: Using Debbugs. +* Tracking Bugs and Patches:: Keeping it all organized. * Commit Access:: Pushing to the official repository. * Updating the Guix Package:: Updating the Guix package definition. * Translating Guix:: Make Guix speak your native language. @@ -1223,6 +1223,18 @@ for more information. You can install @command{git = send-email} with @node Tracking Bugs and Patches @section Tracking Bugs and Patches =20 +This section describes how the Guix project tracks its bug reports and +patch submissions. + +@menu +* Debbugs:: The official bug and patch tracker. +* Debbugs User Interfaces:: Ways to interact with Debbugs. +* Debbugs Usertags:: Tag reports with custom labels. +@end menu + +@node Debbugs +@subsection Debbugs + @cindex bug reports, tracking @cindex patch submissions, tracking @cindex issue tracking @@ -1234,6 +1246,9 @@ email to @email{bug-guix@@gnu.org}, while patch submi= ssions are filed against the @code{guix-patches} package by sending email to @email{guix-patches@@gnu.org} (@pxref{Submitting Patches}). =20 +@node Debbugs User Interfaces +@subsection Debbugs User Interfaces + A web interface (actually @emph{two} web interfaces!) are available to browse issues: =20 @@ -1271,6 +1286,50 @@ For example, to list all open issues on @code{guix-p= atches}, hit: @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on this nifty tool! =20 +@node Debbugs Usertags +@subsection Debbugs Usertags + +@cindex usertags, for debbugs +@cindex Debbugs usertags +Debbugs provides a feature called ``usertags'' that allows any user to +tag any bug with an arbitrary label. Bugs can be searched by usertag, +so this is a handy way to organize bugs.@footnote{The list of usertags +is public information, and anyone can modify any user's list of +usertags, so keep that in mind if you choose to use this feature.} + +For example, to view all the bug reports (or patches, in the case of +guix-patches) tagged with the usertag @code{powerpc64le-linux} for the +user @code{guix-devel@@gnu.org}, open a URL like the following in a web +browser: +@url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=3Dpowerpc64le-linux= ;users=3Dguix-devel@@gnu.org} + +For more information on how to use usertags, please refer to the +documentation for Debbugs or the documentation for whatever tool you use +to interact with Debbugs. + +In Guix, we are experimenting with usertags to keep track of +architecture-specific issues. To facilitate collaboration, all our +usertags are associated with the single user @code{guix-devel@@gnu.org}. +The following usertags currently exist for that user: + +@table @code + +@item powerpc64le-linux +The purpose of this usertag is to make it easy to find the issues that +matter most for the @code{powerpc64le-linux} system type. Please assign +this usertag to issues or patches that affect @code{powerpc64le-linux} +but not other system types. In addition, you may use it to identify +issues that for some reason are particularly important for the +@code{powerpc64le-linux} system type, even if the issue affects other +system types, too. + +@end table + +If you're a committer and you want to add a usertag, just start using it +with the @code{guix-devel@@gnu.org} user. If the usertag proves useful +to you, consider updating this section of the manual so that others will +know what your usertag means. + @node Commit Access @section Commit Access =20 =2D-=20 2.30.2 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAmDSoRoVHGNtbWFydXNp Y2hAZ21haWwuY29tAAoJEN1AmhXYIkadhj8QAM82Xc3VrickrdOfmr1PoWIOXHbg pBpshW5WsG5h2SvMK4R1paxEmylzEfoytjq32ZNdtXA36BX6XTXRJUrHfEtdZLNa J/vcB3L2OFurcykS9y6ZFwtZ0NLs+jdDDJSm+bvz9lFt+YMFzt1LtnD8hqRFAQ59 BcWM/QhdDFinnwLy8eccV7CS6OEcoBb1mbt1tHEz6T/vNE4gjGH5jvz+aLjCAYR/ mB4qUImvYmSFW4RM4kWU3Ytr7jRYCzkgsaEW7SCFlZwFrpDijJ7G9tGrrY6C7nFy FFmQiHf1qUIZ+sR+Tx0bsyVZeEA7oevIZwuQgaQbv/AGuiPzAcFENjKnVEFVFC+y gAgQYaM1ZIlLkA+f6NuAmTLgqkSmaie5kgTipvwcTxulBf7Tp0zWtt1PqiHGvpgw rmxznK56O6quEk8hDVszKrgv/GbVrx3WPGiCYAdZD4sOfjAAnCCeu7XTSYRIe1fR g6OSl34Ci0v2n6Yvw1KiRm1tKOZfTSdXXu51R7CwYMnkAPRdGbqvdPOoYFAImpgr 2PVGTtaXPREYO4yVeI/O4GWyCco16wxAnBVBdIddElTYnT/YfBng39K5+W2yk9yJ BmXPFH6rVR9crcTj2WR4ALQnV70/rIphYKIbXuXsfbBPyObggucRVe0PciytwENa 71IgGcziCnHuAdLe =HWQi -----END PGP SIGNATURE----- --==-=-=--