Tags and usertags

The BTS supports tagging mechanisms to organize and manage bugs:

There are 2 typical use cases of the usertags:

Package centric usertags

The use of package centric usertags enables to organize the default BTS package view if usercategory is set for the package. See BTS for devscripts as an example.

Here are some typical cases:

To report a bug on the bts command in the devscripts package with its version 1.0, you set the pseudo-header fields like this:

Package: devscripts
Version: 1.0
User: devscripts@packages.debian.org
Usertags: bts


The fields User and Usertags control the user tags for the bug report.

If you wish to set usertags to bts for an bug# 12345, you send an e-mail to control@bugs.debian.org with the following content:

user devscripts@packages.debian.org
usertags 12345 bts

Alternatively, you may use the bts command from the shell as:

 $ bts user devscripts@packages.debian.org , usertags 12345 bts

The tweaking of usercategory should be done only by people involved with resolving bugs.

Personal or team usertags

The use of personal or team usertag enables to organize the user specific BTS package view associated to a user identified by a personal e-mail address or a team e-mail address.

The email address is not important and doesn't even need to be valid. It just provides a namespace for the tag to exist in. This means there is no need to co-ordinate a central list of tags.

If you wish to mark bug# 12345 as todo, use the bts command from the shell as:

 $ bts user foo@example.org , usertags 12345 todo

Then, you can see all bugs with the todo usertags with https://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=todo;users=foo@example.org

Note on usercategory and display

Use <pkg>@packages.debian.org as user@domain.tld (only if you are actually from that team).

  1. pay attention at the order you write the tags in the usercategory, since it will be the same order the tags will show up on the BTS page.

  2. when you add a tag to bugs, you need to modify the usercategory to treat that tag too (I don't like this, but that's the way it is).

  3. you can add a usertag to usercategory even if no bug is usertagged (yet) with it: it will appears as soon a some bugs will have that usertag.

  4. usertag name can have only alphanumerics, at, dot, plus and dash, while <cat> in <cat> [<tag>] can have underscore too (maybe other chars, untested).

Access to usertags and usercategories

Usertags are available on the bugs page for individual packages, via the BTS SOAP interface, in UDD, via a UDD CGI and via rsync:

rsync rsync://bugs-mirror.debian.org/bts-spool-index/user/*/someone*example.org ./


Comments about usertags can go on this page...

from #debian-mentors:

<pabs> ooh, usertags
<pabs> bts++
<Nigel> pabs: i thought it was a random users suggestion at first, was about to reply, "HAHAHA, they will never do that"
<pabs> :)
<pabs> aj does roxor
<Nigel> yeah
<Nigel> i must go and set usertags on all my bugs now...
<Nigel> i must say the following though: it'd be nice for the maintainer to get a copy of all tags set...
<pabs> yeah, indeed
<Nigel> also, it'd be nice if there was a link up the top now, with "Maintainers Tags"
<Nigel> or (dunno if this defeats the purpose) set it up so tags set against the maintainer's email address, or the package@packages.d.o addy shown by default...
<pabs> even better, add a thing to reqest@ for advertising usertags by default for a certain user/package/etc combo
<pabs> adding it to the wiki page :)

One could add a option to the CGI to select a predefined categorisation class. I would like to say something like

 Example 1:

Another useful addition could be to be able to globally rearrange the ordering of the categories. If I have used example 1 and now I want to rearrange the categorisation to move Severity to the top level I currently would have to do that (we assume for a moment the class parameters would actually work):

 Example 2:

Here my first tries with categorisation together with usertags:

by ?FrankLichtenheld

It would also be very nice to use the package a bug is filed against to divide them into sections. I'd like to use something like this:

   ttl1=Pending removal,Waiting for adoption,No answer yet;

by ?MarcBrockschmidt

(This is done.)


Here's a useful view in the BTS: https://bugs.debian.org/cgi-bin/pkgreport.cgi?tag=security;users=debian-security@lists.debian.org;ordering=tracked