summaryrefslogtreecommitdiff
path: root/doc/contributing.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2026-01-23 10:26:45 +0100
committerCayetano Santos <csantosb@inventati.org>2026-02-03 07:58:21 +0100
commitc36602a36d21f76d5ae71a39411b47a3b035fc76 (patch)
tree5525efad8ae26ecd877f01dadb7a0a4b49d58b9d /doc/contributing.texi
parent9d22a2eef773db24837ddcfc84a5b3b7078cce8c (diff)
doc: Remove “Debbugs Usertags” section.
* doc/contributing.texi (Debbugs Usertags): Remove. Merges guix/guix!5840 Change-Id: If550e31918c495ed24578fcbaaa179eb36521687 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
Diffstat (limited to 'doc/contributing.texi')
-rw-r--r--doc/contributing.texi60
1 files changed, 1 insertions, 59 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 068c51f9a05..1f23f92b844 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -2163,7 +2163,6 @@ patch submissions and topic branches.
2163* The Issue Tracker:: The official bug and patch tracker. 2163* The Issue Tracker:: The official bug and patch tracker.
2164* Managing Patches and Branches:: How changes to Guix are managed. 2164* Managing Patches and Branches:: How changes to Guix are managed.
2165* Debbugs User Interfaces:: Ways to interact with Debbugs. 2165* Debbugs User Interfaces:: Ways to interact with Debbugs.
2166* Debbugs Usertags:: Tag reports with custom labels.
2167* Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds. 2166* Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds.
2168@end menu 2167@end menu
2169 2168
@@ -2487,63 +2486,6 @@ used.
2487@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on 2486@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on
2488this nifty tool! 2487this nifty tool!
2489 2488
2490@node Debbugs Usertags
2491@subsection Debbugs Usertags
2492
2493@cindex usertags, for debbugs
2494@cindex Debbugs usertags
2495Debbugs provides a feature called @dfn{usertags} that allows any user to
2496tag any bug with an arbitrary label. Bugs can be searched by usertag,
2497so this is a handy way to organize bugs@footnote{The list of usertags is
2498public information, and anyone can modify any user's list of usertags,
2499so keep that in mind if you choose to use this feature.}. If you use
2500Emacs Debbugs, the entry-point to consult existing usertags is the
2501@samp{C-u M-x debbugs-gnu-usertags} procedure. To set a usertag, press
2502@samp{C} while consulting a bug within the *Guix-Patches* buffer opened
2503with @samp{C-u M-x debbugs-gnu-bugs} buffer, then select @code{usertag}
2504and follow the instructions.
2505
2506For example, to view all the bug reports (or patches, in the case of
2507@code{guix-patches}) tagged with the usertag @code{powerpc64le-linux}
2508for the user @code{guix}, open a URL like the following in a web
2509browser:
2510@url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=powerpc64le-linux;users=guix}.
2511
2512For more information on how to use usertags, please refer to the
2513documentation for Debbugs or the documentation for whatever tool you use
2514to interact with Debbugs.
2515
2516In Guix, we are experimenting with usertags to keep track of
2517architecture-specific issues, as well as reviewed ones. To facilitate
2518collaboration, all our usertags are associated with the single user
2519@code{guix}. The following usertags currently exist for that user:
2520
2521@table @code
2522
2523@item powerpc64le-linux
2524The purpose of this usertag is to make it easy to find the issues that
2525matter most for the @code{powerpc64le-linux} system type. Please assign
2526this usertag to bugs or patches that affect @code{powerpc64le-linux} but
2527not other system types. In addition, you may use it to identify issues
2528that for some reason are particularly important for the
2529@code{powerpc64le-linux} system type, even if the issue affects other
2530system types, too.
2531
2532@item reproducibility
2533For issues related to reproducibility. For example, it would be
2534appropriate to assign this usertag to a bug report for a package that
2535fails to build reproducibly.
2536
2537@item reviewed-looks-good
2538You have reviewed the series and it looks good to you (LGTM).
2539
2540@end table
2541
2542If you're a committer and you want to add a usertag, just start using it
2543with the @code{guix} user. If the usertag proves useful to you,
2544consider updating this section of the manual so that others will know
2545what your usertag means.
2546
2547@node Cuirass Build Notifications 2489@node Cuirass Build Notifications
2548@subsection Cuirass Build Notifications 2490@subsection Cuirass Build Notifications
2549 2491
@@ -3045,7 +2987,7 @@ to that commit message.
3045 2987
3046If you are not a committer, you can help others find a @emph{series} you 2988If you are not a committer, you can help others find a @emph{series} you
3047have reviewed more easily by adding a @code{reviewed-looks-good} usertag 2989have reviewed more easily by adding a @code{reviewed-looks-good} usertag
3048for the @code{guix} user (@pxref{Debbugs Usertags}). 2990for the @code{guix} user.
3049 2991
3050@node Updating the Guix Package 2992@node Updating the Guix Package
3051@section Updating the Guix Package 2993@section Updating the Guix Package