Re: Handling bug reports on user documentation

[Andre Klapper <ak-47 gmx net>]

On Fri, 2012-02-10 at 15:52 -0500, Shaun McCance wrote:
> On Fri, 2012-02-10 at 12:23 +0100, Andre Klapper wrote:
> > * Some products in GNOME Bugzilla have a "docs", "Documentation", 
> >   or "User Guide" component
> >   * Most of these components have the (virtual) default assignee
> >     gnome-user-docs-maint gnome bugs
> >     * Half of the products with gnome-user-docs-maint gnome bugs 
> >       as "Default Assignee" also have it as "Default QA Contact", 
> >       half of them doesn't. 
> >       Not a big issue but it makes those reports not easily 
> >       watchable for module maintainers as they would have to 
> >       follow all of gnome-user-docs-maint@'s bugmail.
> 
> I think my original proposal was something like this:
> 
> * If the docs team at large owns it, set gnome-user-docs-maint as
> the default assignee. Set the default QA contact to whatever you
> want, possibly your own -maint alias so you can watch the bugs.
> 
> * If somebody on your team owns it, but you still want the docs
> team involved, use something for default assignee, but set the
> default QA contact to gnome-user-docs-maint.

Makes sense.

> >   * Some "docs" components have the default assignee shaunm
> This should basically never, ever, ever happen.

I've fixed the defaults of the affected Bugzilla products and for all
open tickets (which was exactly one).

> > * Some products have NO "docs" component (e.g. brasero). Reports 
> >   require manual reassigning to gnome-user-docs-maint gnome bugs .
> >   It is likely that this does not always work perfectly. ;-)
> 
> These should be fixed.

The problem is how to identify them... Might need quite some manual
reviewing when I'm bored at the Docs Hackfest. :P

> > * There is a "documentation" keyword that is used broadly (mostly 
> >   for developer docs?) with 157 open reports:
> >   https://bugzilla.gnome.org/buglist.cgi?resolution=---&keywords=documentation
> 
> And I never use the documentation keyword.

The keyword description says "This bug (or something in it) needs
documenting."
Querying for reports that got the "documentation" keyword *added*:
* in the last  90 days[1]:   2
* in the last  365 days:     5
* in the last  730 days:    16
* in the last 1825 days:    28

=> Usage seems to not be very widespread anyway.
Removing the keyword (used by 1816 tickets in total) might be too noisy,
but we could update the keyword description and give better instructions
(file a ticket in the Docs component for user docs issues, or something
similar, no idea about devel-docs though).

andre


[1] https://bugzilla.gnome.org/buglist.cgi?chfieldto=Now;query_format=advanced;chfield=keywords;chfieldfrom=-90d;chfieldvalue=documentation
-- 
mailto:ak-47 gmx net | failed
http://blogs.gnome.org/aklapper