From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id mHEdCygR1GDnSAAAgWs5BA (envelope-from ) for ; Thu, 24 Jun 2021 06:59:20 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id eAu8BigR1GA1XAAAbx9fmQ (envelope-from ) for ; Thu, 24 Jun 2021 04:59:20 +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 444D52294B for ; Thu, 24 Jun 2021 06:59:19 +0200 (CEST) Received: from localhost ([::1]:35664 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lwHSQ-0008Pz-6U for larch@yhetil.org; Thu, 24 Jun 2021 00:59:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:32996) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lwHSF-0008NX-3Y for guix-devel@gnu.org; Thu, 24 Jun 2021 00:59:07 -0400 Received: from mail-pf1-x42b.google.com ([2607:f8b0:4864:20::42b]:40692) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lwHSD-00012e-6z; Thu, 24 Jun 2021 00:59:06 -0400 Received: by mail-pf1-x42b.google.com with SMTP id q192so4150415pfc.7; Wed, 23 Jun 2021 21:59:04 -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=UL+ad2GvSQVDDRLbbxZg0E2brm00aUhGB6/N1FyeV8w=; b=cTfQeRb9j+S3wZrWwznZhcTLHqh/HxIUj2mpLxWM8PmpL35CiXH6K37JKwYRZ1UW9H MrdsIp3uhD/zJl+QNVxUVyscYPm67/rRuCFymludTIwUkwRwjVh+5Vo/Jsft1uyc5gzF WCWJeC/3+78xRzuhigBbxfL6gTsvJ7Ui1g5W/wUUBC841rMbRX2XGvUyJZGzSCMauibh R4EzEByxYc+BRQYphv4orW59fIL/oEmLp3YSGq3ne5j2aUVptqKUSvKRZQgHUv0DSx/o y96zse+bIYHnucp5iOmHjdHX+poAeNKBk0Cicft0UI96BibcmlXKcg6DrqOApDqXWjHk uXtw== 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=UL+ad2GvSQVDDRLbbxZg0E2brm00aUhGB6/N1FyeV8w=; b=SXajORqEO1JWOKsoGBk5iWjcfcyoFdsJJr3OpEisMqx4edpucV+G9BbhmMRuvtxZ5c qstAZthCRLLemuLimobYuZ9f4oDUlmHw3xDB5l8nYpo80y0+5hNNX46QivrE9qx4sTZc v6JTox68mRjxWjpJAf/Z5gubMZNqn3S6Kf1qb1OLmKe1Hu9J6yOh2CDw3fTLlsOdozrC gB1jNGlVSVbVCBp3zXrInHOX4Pgk5+3v4MEus4mFmYyMwC7Exe/wLopNzez0gTwHvYRA bzsRaJkhNlgvNq7tM2vpiAvNaGh5VJ+5pOi0XkC/hy+qonFhS9XYNH4vNmGXq9uLSCgV veqA== X-Gm-Message-State: AOAM532oirMTrUKIAVgyJoY/SUVP00VZDz5tZuLZijJ2sbFYLEzXbT0B Ql0CyJMG0KbFnqpDcU3h4HhnFA7uxmmUIA== X-Google-Smtp-Source: ABdhPJwPqmDDx0vPKzom5mZsta8lEvGt3b38ishyum9RC30wdCa8uODHipp95A76epp9vRviCcANgQ== X-Received: by 2002:a63:f557:: with SMTP id e23mr3027723pgk.55.1624510743040; Wed, 23 Jun 2021 21:59:03 -0700 (PDT) Received: from garuda-lan ([2601:601:9d01:3f90::24aa]) by smtp.gmail.com with ESMTPSA id a15sm1344462pff.128.2021.06.23.21.59.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Jun 2021 21:59:02 -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> <871r8tb8it.fsf@gmail.com> <87wnqkwuu1.fsf@gnu.org> Date: Wed, 23 Jun 2021 21:59:00 -0700 In-Reply-To: <87wnqkwuu1.fsf@gnu.org> ("Ludovic =?utf-8?Q?Court=C3=A8s=22'?= =?utf-8?Q?s?= message of "Wed, 23 Jun 2021 15:53:42 +0200") Message-ID: <87r1gramej.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::42b; envelope-from=cmmarusich@gmail.com; helo=mail-pf1-x42b.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=1624510759; 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=UL+ad2GvSQVDDRLbbxZg0E2brm00aUhGB6/N1FyeV8w=; b=CsqXGeXj4vDytGpD7Jxg0OISJ4wvaCZaBBNQbjeMRp2HyKuA2+YDmHHF9iTFE5hEiT6PgL 4DXQQRnvxfhimOAlEmhOu/AoD1IK1B111W3oMbJsT6CIRMWMJJXWOYOKHPyQw73mnmz++n sS4xchS/A+eH0mXnAvCnwTF9/9TIsfH7UcPg/xOFlev4xhULr0ooYR3Qxs3feU7JVZPnqe 4m3coVL85m++icbgTvGt1E+bFtdEuXfSk0A3I1HJNSHR/Sv/3/2XsJWj8f0iHJWoKITuT/ /weJhlXY6U6nbgILhAin/fTg2n0BOMHq9gDni/2KoNxqKAMWYPMrVdsGDxM74A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1624510759; a=rsa-sha256; cv=none; b=L7bTxH8Htrlc9GeYiNcN8FfEnQWP81h4q0k9HyjR1bF/Qk/pEqULcZ8dlYcVxXf0gYZIq5 O5ZLlV3HabNRwX+Rt0z58RXZ42CiPnjZ1Mx2LHyNGvn8LJGjSrHVRXVTlr4+rhm3COxRUh G1U54+jgA9oy2ufuJKxTlegC+7MaKPyeD++08QEc396PoiQdjvD3KC2s4eAuUHHLFJ5oc4 xWngmg0Vn9rC5I2xAfqbLlt0PlU9+dHULvarIbX/az4WlO+d7sPVtH47MaTG34pLk0AWkZ XgVxdwGVk+fE6wkOy+/CGhQD9+hU10U+twBP8fLuQPpLLPTaVXR43qjwKE02Iw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=cTfQeRb9; 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.93 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=cTfQeRb9; 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: 444D52294B X-Spam-Score: -1.93 X-Migadu-Scanner: scn0.migadu.com X-TUID: Zj4UnsknxTnb --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Ludovic Court=C3=A8s writes: >> * 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 subsectio= ns, >> titled "Debbugs", "Debbugs User Interfaces", and "Debbugs Usertags". Of >> these, only the "Debbugs Usertags" is actually new. > > Wonderful! I'm glad you like it! :-) >> +++ 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. >> -* Tracking Bugs and Patches:: Using Debbugs. >> +* Tracking Bugs and Patches:: Keeping it all organized. > > You probably have to adjust it in a second place (yeah=E2=80=A6). Other references to "Tracking Bugs and Patches" do exist, but they don't mention "Using Debbugs," so I don't think they need to be updated. >> +@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 > > =E2=80=98M-x texinfo-make-menu=E2=80=99 or similar should indent it for y= ou. :-) You learn something new every day! >> +@node Debbugs >> +@subsection Debbugs > > Maybe rename to =E2=80=9CThe Issue Tracker=E2=80=9D, so as to not require= knowledge of > what Debbugs is when skimming through the table of contents? Sounds good. I just changed the first subsection, so now it looks like this: =2D-8<---------------cut here---------------start------------->8--- @menu * The Issue Tracker:: The official bug and patch tracker. * Debbugs User Interfaces:: Ways to interact with Debbugs. * Debbugs Usertags:: Tag reports with custom labels. @end menu =2D-8<---------------cut here---------------end--------------->8--- This seems fine, since the first subsection introduces Debbugs. >> +Debbugs provides a feature called ``usertags'' that allows any user to > > @dfn{usertags} OK. >> +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. > > Maybe we can already add =E2=80=98reproducibility=E2=80=99. > > Otherwise LGTM, thank you! > > Ludo=E2=80=99. I added this text: =2D-8<---------------cut here---------------start------------->8--- @item reproducibility For issues related to reproducibility. For example, it would be appropriate to assign this usertag to a bug report for a package that fails to build reproducibly. =2D-8<---------------cut here---------------end--------------->8--- I've gone ahead and committed these changes in 3c86372e36cecaed1ad55675ce32a14b972406bf. I verified that the Texinfo manual could be built, and that when viewing it in Info, it looks as expected. Please let me know if you'd like any further changes; I'd be happy to make them. =2D-=20 Chris --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAmDUERQVHGNtbWFydXNp Y2hAZ21haWwuY29tAAoJEN1AmhXYIkadK14P+wcm86dpaRFXX5XmTjLoAslcEg9D 2C7mPhVRxzqlrEs0WwPpxmTnfdkyjBdQdYPuTKpbqAKX12nzYrLe2bfKWPVXN323 OZJe/HZ2NKGL6IloE0XmuYSmGjHm+2YJ9EP0wCqVm3OEmvvVhQhTiCfS/RdS4DVd 359nCPOQ7X5jzk3I4DDeLyN/B9qiTyBPRL/9S/9zMwAlQycEWY3TsXCdfZOxejAB YY/A4z0pfGD+rP75rhJHvwe5/nALAWRBzoqqRgEgORdWp2JS+uTLux5NG7wzopA/ Nns3yGtdkLmcBCtWwccuiOYpAPImVnV2OZr1Rs3w3E3irWvtQjYvMADqY9A6GtzE 9yy0hc1cL+HTXagvbl/aKpdaqkyJgx3cLcw6cCTUNuT+ccbddS8p9YR46Pa3we+L ojcRiJyHwfN1et7LjJE9UdZEYzdOmpIqYgVuD2x7SgsP/JtB6IFU0hSRpx38gPGT 8wujoY2oRsRjBk/LJRtBfuGt5ZqKYkbxla0t6TVsKvtyrlC8Eb7C4DoSFeBoKsWz PacUN4tYHpAPvdhabottFYsuOuwc6QTdIzNv0VSrDSQMGpU55CAHm26OiLGfifg2 wc9Bss0aZGJREllffDoaiWU6ixA1C6qBw6ePElxdL6yr7t9kRFjX8TXJZemwHA57 DYQGfeibH/a/K9Q9 =ehqQ -----END PGP SIGNATURE----- --=-=-=--