Bug#367876: developers-reference: please recommend usertags for mass bug filing

[Chris Lamb <chris@chris-lamb.co.uk>]

tags 367876 + patch
thanks

> IMO it is a best-practice to set usertags when filing lots of bugs for
> a given problem,

Patch attached.

> please get consensus how it should be chosen and what will be the choice
> of e-mail adress for each types of reasons on debin-devel@LDO. 

I don't really see the benefit of this -- it's not really the job of the
devref to to document how various groups use their usertags, so enumerating 
them here would only really lead to developers usertagging bugs--with good
intentions--but incorrectly. Futhermore, some usertags are likely to be
"restricted" in an informal manner (similar to how the "etch" and "lenny"
tags operate at the moment).


Regards,

-- 
Chris Lamb, UK                                       chris@chris-lamb.co.uk
                                                            GPG: 0x634F9A20

commit 64804ff791bdcbd49b62a8de4332906a0066f10c
Author: Chris Lamb <chris@chris-lamb.co.uk>
Date:   Sat Jul 12 18:54:43 2008 +0100

    Add information about usertags with resepect to mass bug filing. (Closes: #367876)
    
    Signed-off-by: Chris Lamb <chris@chris-lamb.co.uk>

diff --git a/beyond-pkging.dbk b/beyond-pkging.dbk
index 77a9739..6cc5d63 100644
--- a/beyond-pkging.dbk
+++ b/beyond-pkging.dbk
@@ -94,6 +94,41 @@ Note that when sending lots of bugs on the same subject, you should send the
 bug report to <email>maintonly@&bugs-host;</email> so that the bug report
 is not forwarded to the bug distribution mailing list.
 </para>
+<section id="usertags">
+<title>Usertags</title>
+<para>
+You may wish to use BTS usertags when submitting bugs across a number of
+packages. Usertags are similar to normal tags such as 'patch' and 'wishlist'
+but differ in that they are user-defined and occupy a namespace that is
+unique to a particular user. This allows multiple sets of developers to
+'usertag' the same bug in different ways without conflicting.
+</para>
+<para>
+To add usertags when filing bugs, specify the <literal>User</literal> and
+<literal>Usertags</literal> pseudo-headers:
+</para>
+<screen>
+To: submit@bugs.debian.org
+Subject: <replaceable>&lt;title-of-bug&gt;</replaceable>
+
+Package: <replaceable>&lt;pkgname&gt;</replaceable>
+<replaceable>[ ... ]</replaceable>
+User: <replaceable>&lt;email-addr&gt;</replaceable>
+Usertags: <replaceable>&lt;tag-name&gt; [ &lt;tag-name&gt; ... ]</replaceable>
+
+<replaceable>&lt;description-of-bug ...&gt;</replaceable>
+</screen>
+<para>
+Note that tags are seperated by spaces and cannot contain underscores. If you
+are filing bugs for for a particular group or team it is recommended that you
+set the <literal>User</literal> to an appropriate mailing list after describing
+your intention there.
+</para>
+<para>
+To view bugs tagged with a specific usertag, visit
+<literal>http://&bugs-host;/cgi-bin/pkgreport.cgi?users=<replaceable>&lt;email-addr&gt;</replaceable>&amp;tag=<replaceable>&lt;tag-name&gt;</replaceable></literal>.
+</para>
+</section>
 </section>
 
 </section>

Attachment: signature.asc
Description: PGP signature