Bugzilla User Guidelines

A design space for creating more prominent and effective guidelines for using Bugzilla.

This will probably need to be moved somewhere else if it goes anywhere.


  • Prompt people to provide high quality bug reports and comments.
  • Provide a clear framework for how Bugzilla works.
  • Ensure that Bugzilla users have realistic expectations.
  • Promote good behaviour and prevent bad behaviour.
  • Be quick to read and easy to remember.


  • Not a guide for triagers, maintainers or administrators.

Relevant Art

GNOME: https://bugzilla.gnome.org/page.cgi?id=bug-writing.html

Mozilla: https://quality.mozilla.org/docs/bugzilla/starter-kit/how-to-write-a-proper-bug/

Mozilla: https://bugzilla.mozilla.org/page.cgi?id=etiquette.html

Mediawiki: http://www.mediawiki.org/wiki/How_to_report_a_bug

Fedora: https://fedoraproject.org/wiki/How_to_file_a_bug_report

Wikipedia: http://en.wikipedia.org/wiki/Wikipedia:Bug_reports_and_feature_requests

Useful Sources

Fabiana Simoes - How Not to Report Your UX Bug


AllanDay/BugzillaUserGuidelines (last edited 2014-02-23 12:26:42 by AllanDay)