Bug management/Phabricator etiquette

Please follow these guidelines to ensure that Bugzilla is a productive, constructive and collaborative environment for managing bug reports and feature requests.

Leave actionable comments. Comments should be directly related to reporting, confirming, evaluating the severity, or fixing the bug. Constructive and helpful thoughts unrelated to the topic of the report (for example, meta-level discussions on priorities in general or on whether a new extension is wanted at all) should go to the appropriate mailing lists or wiki talk pages.

No obligation. We're all here because we care, but your desires don't translate into an obligation for anyone other than you to work on them. Therefore, you should not act as if you expect someone to fix a bug by a particular date or release, nor as if bug reporters and commenters have an obligation to become professional testers for you. Aggressive or repeated demands will not be received well and will almost certainly diminish the impact and interest in your suggestions. Providing a patch often helps to speed up a bug fix; +2 is one policy for approving proposed code.

Criticize ideas, not people. A healthy amount of constructive criticism helps to improve software. Vibrant debate inside of the Wikimedia community is encouraged. In cases of disagreement, effectively argue your case without making conflicts personal; always treat people respectfully. Focus on development matters such as user stories, interfaces, algorithms and implementation details, rather than on specific individuals.

Act in public. Unless you were asked to email someone with specific information, place all technical information relating to a bug report in the report itself.

Bug fields aim for realism. Bug status, priority and milestone should reflect reality (in summary form), not cause it. Avoid changing a status if you don't have experience doing so in the component in question: instead, argue persuasively in the report that the bug has serious user impact, or provide a patch. Generally, if in doubt, don't make changes yourself; instead, read about the meaning of the fields and add a comment suggesting the change and convincing reasons for it.

Repeatedly ignoring these guidelines may result in losing  rights on Bugzilla, or the disabling of your Bugzilla account.

If you see someone not following these guidelines, the first step is to make them aware of this document. This can be done through private email in minor cases, or in public in major cases to avoid any later assumptions of tolerated behavior. In the case of persistent disregard of these guidelines, ping a Bugzilla administrator on Wikimedia IRC or send an email to the bug wrangler and ask him or her to look into it.

Document inspiration

 * https://bugzilla.mozilla.org/page.cgi?id=etiquette.html (CC BY-SA 3.0)
 * https://developer.mozilla.org/en-US/docs/What_to_do_and_what_not_to_do_in_Bugzilla
 * conversation on teampractices@, referring to the use of RESOLVED WONTFIX and related problems