Andre Klapper wrote:
being WMF's new "bug wrangler" I would
like to improve documentation on
bug management/triaging in order to make it easier to get involved and
understand how things work. As a side effect it will also help myself in
understanding things better. :)
It's never been very clear who the primary audience of Bugzilla is (or
whether there even is a "primary" audience of Bugzilla). I think it will be
difficult to write good documentation if you don't know whether your
audience is primarily developers, primarily end-users, or some mixture.
I mention this because, for example, it may not be a great use of time to
make bug filing documentation simpler if the real end goal is to have most
end-users not use Bugzilla. There are further thoughts on this here:
<https://bugzilla.wikimedia.org/show_bug.cgi?id=27852>.
That said, bug management is mostly distinct from bug filing. Your post to
the village pump seems to encompass both, but I'm not sure if you're
actually planning on trying to tackle both right now. (Your mailing list
post seems to focus more on bug management/triaging.)
Current content feels inconsistent and scattered
across several wikis,
plus after reorganizing I'd like to extend it with some pages I consider
useful (e.g. starting a proper Triage Guide, and a page listing URLs of
upstream bugtrackers).
Sounds like a typical wiki content evolution. :-) The pages could all
definitely use some love. Thanks for volunteering!
My (old but still valid) proposal is available at
https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28technical%29/Archiv…
00#Improving_Documentation_on_Handling_Bug_Reports
This previous wiki post looks pretty good. It's very thorough and caught
most of the pages that I thought of off-hand when I read your subject line.
I agree with Siebrand that you should use
MediaWiki.org or Meta-Wiki for
work like this. I'd also strongly recommend not deleting old pages (or old
page titles). Redirects are cheap and are vastly more useful to readers.
MZMcBride