Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Contributing to Devtools
Help make the Firefox developer tools better by filing bugs and writing code.
Filing a Bug
If you notice a bug in the developer tools, please file a bug on Bugzilla. You'll have to create a Bugzilla account to do so, but that only takes a couple minutes.
Finding a Bug to Fix
If you notice a issue with the tools, you could actually fix it yourself. If a bug doesn't exist yet, file one, and assign the bug to yourself saying that you plan on fixing it.
If you'd like to contribute, but haven't found a bug, you can search for good first bugs on Bugzilla.
At any point if you can't figure out how to do something, you can get help on IRC. Get an IRC client (like LimeChat on OS X), log onto the
irc.mozilla.org network, and join the
Ask your question in the channel, and someone who knows about that area will respond. The best times to ask are in the afternoon on European time or morning in US time on weekdays, when the most people are watching the channel. Everyone is nice there.
Writing a patch
To write a patch for a devtools bug, you'll need to build Firefox locally and create a patch using the Mercurial VCS. There's a lot of help over at the MDN Developer Guide. The steps to getting a patch in devtools are:
To write a devtools patch, you'll need to check out the Firefox source code and build it. Check out these directions for building.
Devtools uses the "fx-team" branch, not mozilla-central, so you'll want to checkout the code with:
hg checkout https://hg.mozilla.org/integration/fx-team
Editing the Devtools Code
browser/devtools directory of the Mozilla source code. However, if you're changing the server actors for the remote debugging protocol, you'll find that code in
Finding out where to make your changes can be tricky. Generally, each tool has its own subdirectory under the
devtools directory. It can be helpful to grep for strings you see in the UI or class names you see on elements of the tool's UI (you can find this using the DOM Inspector and Inspect Context addons).
If you need a pointer in the right direction, just ask in IRC.
Trying Out Your Changes
Most of the time, you'll only need to rebuild the
browser directory after making a change to the devtool's code:
./mach build browser
After re-building you can restart Firefox to see the changes reflected. The Restartless Restart addon is handy for this.
Testing Your Changes
You'll want to make sure the devtools tests pass as well. Most devtools tests can be run with this mach command:
./mach mochitest-browser browser/devtools
That can take awhile to run, so you might want to narrow it down to your tool's subdirectory.
Submitting a Patch
Make a patch using Mercurial patch queues, and add it as an attachment to the bug.
Asking for Review
When you attach your patch file to a bug, you should flag someone for review as well, otherwise it might get lost in the ether. Ask in IRC for a good person to review your patch, mentioning the bug number.