Bug management Doc Rewrite

= Improving Documentation on Handling Bug Reports =

Note that this is a first draft and work in progress - see http://lists.wikimedia.org/pipermail/wikitech-l/2012-October/063755.html. Feel free to add comments inline. -- Andre Klapper

Proposal in order to streamline, harmonize and centralize documentation in order to make it easier to get involved. Currently there are sometimes three places covering the same topic.

TODO: Check pages not listed here, but listed in http://www.mediawiki.org/wiki/Category:Bugzilla

Current situation as per pages and their content

 * https://meta.wikimedia.org/wiki/Bugzilla
 * Basic Bugzilla introduction
 * List of some useful queries
 * https://www.mediawiki.org/wiki/Bugzilla
 * How to submit a report
 * Prefix linkification in bug report comments
 * Bugzilla Registration
 * Hiding your email address
 * Link to Explanation of Fields (Prio/Seve) --> https://www.mediawiki.org/wiki/Bug_management/Bugzilla_usage
 * Link to Explanation of Fields (Status) --> https://bugzilla.wikimedia.org/page.cgi?id=fields.html#status
 * List of some useful queries
 * https://www.mediawiki.org/wiki/Bug_management
 * (Activity / Management focused)
 * link to https://www.mediawiki.org/wiki/Bug_management/How_to_triage
 * short "Status" section refering to triage activity
 * List of activities/tasks in Bugzilla ("Timeline")
 * "Documentation": links to "Bugzilla_usage","How_are_bugs_fixed" and "Triage"
 * https://en.wikipedia.org/wiki/Wikipedia:Bug_reports
 * Basic Bugzilla introduction (and history)
 * How to submit a report
 * Hiding your email address
 * Explanation of Fields (all of them)
 * Voting; Etiquette
 * Prefix linkification in bug report comments
 * List of some useful queries
 * "Other features"
 * https://www.mediawiki.org/wiki/Project:WikiProject_Bug_Squad and subpages
 * Definition of Bug Squad
 * Discussion page with threads
 * Participants list
 * List of activities/tasks in Bugzilla ("Activities")
 * Barnstars
 * https://www.mediawiki.org/wiki/Bugzilla/Fields
 * Explanation of Fields (all of them)
 * https://en.wikipedia.org/wiki/User:MarkAHershberger/Current_TODOs
 * List of activities/tasks in Bugzilla (recurring and future; for Bugmeister)
 * https://www.mediawiki.org/wiki/Bug_management/Bugzilla_usage
 * Basic Bugzilla introduction
 * Explanation of Fields (Prio/Seve)
 * https://en.wikipedia.org/wiki/User:MarkAHershberger/Weekly_reports
 * List of activities/tasks in Bugzilla (past, log; for Bugmeister)
 * https://www.mediawiki.org/wiki/Bug_management/status
 * List of activities/tasks in Bugzilla (past, log; for Bugmeister)
 * https://www.mediawiki.org/wiki/Bug_management/Meeting_prep
 * (empty)
 * https://www.mediawiki.org/wiki/Bug_management/How_to_triage
 * Triaging: Setting priority and assignment
 * Some links to other projects' guides
 * https://www.mediawiki.org/wiki/Bug_management/Triage
 * Basic "Triage" explanation
 * list of old Triage meetings
 * https://www.mediawiki.org/wiki/How_to_report_a_bug
 * How to write a good report
 * https://bugzilla.wikimedia.org/page.cgi?id=bug-writing.html
 * How to write a good report (default unpatched upstream version)
 * https://www.mediawiki.org/wiki/Bug_management/Workflow
 * interesting proposal for change
 * https://www.mediawiki.org/wiki/Bug_management/How_are_bugs_fixed
 * raw dump of a bug report

Proposed pages (not clear which namespace yet), categorized by target group:

 * Everybody's business:
 * Basic introduction: Bug triaging
 * Triage Guide, as "Triage rules can't be just in one person's head" (Luis Villa). For examples see https://wiki.maemo.org/Bugs:Triage_guide or https://live.gnome.org/Bugsquad/TriageGuide . It should be specific to Wikimedia (wild examples: describe when to set the "ops" keyword and who is expected to file a request in RT?; describe anything specific with regard to triaging extensions bug reports in general; how is the "Version" field used or not used; etc.)
 * Basic introduction: Bugzilla
 * Bugzilla Registration
 * Hiding your email address
 * Explanation of Fields (all of them)
 * Prefix linkification in bug report comments
 * Voting; Etiquette
 * One list of some useful queries


 * Users/Bug Reporters:
 * How to write a good bug report


 * Bug Triagers:
 * Bugsquad Community page (existing)
 * Triaging guide
 * Recurring tasks and tasks how to help
 * Triage meetings: General info; list of logs


 * Bugmeister/Bug Wrangler:
 * Status reports etc
 * List of past and current activities/tasks in Bugzilla (for Bugmeister)


 * Developers:
 * Info for project/package maintainer, e.g. how to get a new product listed


 * Deeper knowledge / advanced stuff:
 * Statistics
 * Weekly data reports etc
 * "Other features" etc from Wikipedia:Bug_reports#Other_features
 * Future plans / proposals
 * https://www.mediawiki.org/wiki/Bug_management/Workflow (but maybe should get merged into "How_to_report_a_bug" and might be part of a triage guide)
 * "See Also" from Wikipedia:Bug_reports#See_Also


 * PAGES TO DELETE / redirect to frontpage:
 * https://www.mediawiki.org/wiki/Bug_management/How_are_bugs_fixed
 * https://www.mediawiki.org/wiki/Bug_management/Meeting_prep