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

[Lucas Nussbaum <lucas@lucas-nussbaum.net>]

tags 367876 + pending
thanks

On 12/07/08 at 19:09 +0100, Chris Lamb wrote:
> 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>

Thanks a lot, applied.
-- 
| Lucas Nussbaum
| lucas@lucas-nussbaum.net   http://www.lucas-nussbaum.net/ |
| jabber: lucas@nussbaum.fr             GPG: 1024D/023B3F4F |