# Contributing to Bugzilla

Bugzilla welcomes contribution from everyone. Here are the guidelines if you are
thinking of helping us:

## Contributions

Contributions to Bugzilla should be made in the form of GitHub pull requests.
Each pull request will be reviewed by a core contributor (someone with
permission to land patches) and either landed in the main tree or given
feedback for changes that would be required. All contributions should follow
this format, even those from core contributors.

Should you wish to work on an issue, please claim it first by commenting on
the bug that you want to work on it. This is to prevent duplicated
efforts from contributors on the same issue.

Head over to [BugsAhoy!](https://www.joshmatthews.net/bugsahoy/?bugzilla=1)
to find good tasks to start with. If you come across words or jargon that do
not make sense, please check [FIXME](FIXME) first. If
there's no matching entry, please make a pull request to add one with the
content `TODO` so we can correct that!

See [`README.rst`](README.rst) for more information
on how to start working on Bugzilla.

## Pull Request Checklist

- Branch from the master branch and, if needed, rebase to the current master
  branch before submitting your pull request. If it doesn't merge cleanly with
  master you may be asked to rebase your changes.

- Commits should be as small as possible, while ensuring that each commit is
  correct independently (i.e., each commit should compile and pass tests).

- If your patch is not getting reviewed or you need a specific person to review
  it, you can @-reply a reviewer asking for a review in the pull request or a
  comment, or you can ask for a review in `#bugzilla` on `irc.mozilla.org`.

- Add tests relevant to the fixed bug or new feature.

For specific git instructions, see [GitHub workflow 101](https://github.com/servo/servo/wiki/Github-workflow).

## Conduct

In all Bugzilla-related forums, we follow the
[Mozilla Community Participation Guidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/).
 For escalation or moderation issues, please contact us on Matrix or email bmo-mods@mozilla.com.
 To report incidents use [our online reporting tool](https://app.convercent.com/en-us/Anonymous/IssueIntake/Survey?organizationId=11885ec6-e5a6-e811-80e6-000d3ab6ebad&intakeChannelId=2d885ec6-e5a6-e811-80e6-000d3ab6ebad).
 We will respond within 24 hours.

## Communication

Bugzilla contributors frequent the `#bugzilla.mozilla.org` channel on [`chat.mozilla.org`](https://chat.mozilla.org/#/room/#bmo:mozilla.org).

You can also join the [`bugzilla-dev` mailing list](developers@bugzilla.org).
