Confirmed users
400
edits
(→Resources: Update mxr link to dxr) |
No edit summary |
||
Line 1: | Line 1: | ||
This page is the place to learn how to start contributing to Mobile Firefox, | This page is the place to learn how to start contributing to Mobile Firefox. The current products are Firefox and Focus, on both Android and iOS. | ||
Firefox | Firefox and Focus are developed by the Mozilla community. We're currently focused on making Firefox rock on Android and iOS phones and tablets. We hope this page will help you become an active member of our community! If you're looking for other ways to contribute to Mozilla, have a look at Mozilla's [http://www.mozilla.org/contribute/ global page] for new contributors. Either way, you should also take a look at the [https://www.mozilla.org/en-US/about/governance/policies/participation/ Mozilla Community Participation Guidelines]. | ||
If you still feel that you don't know where to start after reading this page, feel free to [[#Communication|ping us]] on IRC, we can probably give you some ideas. We're always looking for ways to improve this page to make it easier to start contributing. Suggestions and general feedback are more than welcome. | If you still feel that you don't know where to start after reading this page, feel free to [[#Communication|ping us]] on IRC, we can probably give you some ideas. We're always looking for ways to improve this page to make it easier to start contributing. Suggestions and general feedback are more than welcome. | ||
== Hacking == | == Hacking == | ||
Setting up a development environment for Mobile Firefox is relatively easy! All the projects have repos and either a setup script, or a README. | |||
Before starting to work on a bug, you should make sure you have your development environment set up. When you're ready to start hacking, it's a good idea to add a comment to the bug report letting the mentor know that you want to work on it. Ideally, the bug report should already have relevant source code links to help you get started. If you're unsure whether to take a certain bug or not, you can always [[#Communication|contact us]] for clarification. If the bug you're working on involves UI changes, request feedback from the UX team (see contact list [[#Communication|below]]) before landing. | |||
=== Firefox for iOS === | |||
For Firefox for iOS, you should follow the instructions in the [https://github.com/mozilla/firefox-ios Firefox for iOS github repo]. | |||
=== Focus for iOS === | |||
For Firefox for iOS, you should follow the instructions in the [https://github.com/mozilla-mobile/focus-ios Focus for iOS github repo]. | |||
=== Firefox for Android === | |||
Just follow our [https://developer.mozilla.org/en-US/docs/Simple_Firefox_for_Android_build build instructions] and you'll be ready to start hacking after a couple of hours—mostly waiting for everything to compile. Unfortunately, Firefox for Android is more complicated than a basic Android app, so we recommend that you're comfortable using a command line before getting started. | |||
While you're waiting for your build, take a look at our [[Mobile/Fennec/Android/Suggested workflow|suggested workflow]] page. | While you're waiting for your build, take a look at our [[Mobile/Fennec/Android/Suggested workflow|suggested workflow]] page. | ||
For Firefox for iOS, you should follow the instructions in the [https://github.com/mozilla/ | === Focus for Android === | ||
For Firefox for iOS, you should follow the instructions in the [https://github.com/mozilla-mobile/focus-android Focus for Android github repo]. | |||
=== Resources === | === Resources === | ||
Line 32: | Line 40: | ||
=== Mentor Bugs === | === Mentor Bugs === | ||
If you are looking for a bug with guidance, we maintain a set of bugs that are marked with an assigned mentor (see "Whiteboard" field). The mentor will help you get the necessary information to understand the issue, point out relevant parts of the code to look at, etc. You can browse these bugs on [http://www.joshmatthews.net/bugsahoy/?mobileandroid=1 Bugs Ahoy!], but here's a list of unassigned mentor bugs to get you started: | If you are looking for a bug with guidance, we maintain a set of introductory bugs to help get you started! We have a tag called "good first bug" that are accessible for new contributors and will help you get familiar with the code review and landing process. | ||
[https://github.com/mozilla-mobile/focus-ios/labels/good%20first%20bug Focus for iOS] | |||
[https://github.com/mozilla-mobile/focus-android/labels/good%20first%20bug Focus for Android] | |||
==== Firefox for Android ==== | |||
On Bugzilla (for Firefox for Android), good beginner bugs are marked with an assigned mentor (see "Whiteboard" field). The mentor will help you get the necessary information to understand the issue, point out relevant parts of the code to look at, etc. | |||
===== Whiteboard tags ===== | |||
There are some whiteboard tags we use to characterize introductory bugs. Click the links below to see the list of those bugs! | |||
*[https://bugzilla.mozilla.org/buglist.cgi?list_id=11922249&o1=substring&v1=%5bgood%20first%20bug%5d&f1=status_whiteboard&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Android%20Background%20Services&product=Firefox%20for%20Android [good first bug]] | |||
*[https://bugzilla.mozilla.org/buglist.cgi?list_id=11922249&o1=substring&v1=%5bgood%20next%20bug%5d&f1=status_whiteboard&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Android%20Background%20Services&product=Firefox%20for%20Android [good next bug]] | |||
You can browse these bugs on [http://www.joshmatthews.net/bugsahoy/?mobileandroid=1 Bugs Ahoy!], but here's a list of unassigned mentor bugs to get you started: | |||
<bugzilla> | <bugzilla> | ||
Line 44: | Line 65: | ||
} | } | ||
</bugzilla> | </bugzilla> | ||
== Testing == | == Testing == | ||
Line 80: | Line 96: | ||
If you want to talk to people from specific areas or have any questions, here are a few people you can ping: | If you want to talk to people from specific areas or have any questions, here are a few people you can ping: | ||
* '''Android front-end:''' liuche | * '''Android front-end:''' liuche, mcomella, sebastian, grisha, nalexander, rnewman | ||
* '''iOS:''' st3fan | * '''iOS:''' st3fan, jhugman, bkmunar | ||
* '''Android platform:''' | * '''Android platform:'''esawin, gcp, jchen, kats, rbarker, snorp, droeh | ||
* '''QA:''' AaronMT, kbrosnan | * '''QA:''' AaronMT, kbrosnan | ||
* '''Design:''' antlam, tecgirl | * '''Design:''' antlam, tecgirl | ||
* '''Marketing:''' mhan | * '''Marketing:''' mhan | ||
* '''Support:''' rolandtanglao, rrayborn | * '''Support:''' rolandtanglao, rrayborn | ||
* '''Project management:''' jchaulk | * '''Project management:''' jchaulk | ||
* '''Product management:''' | * '''Product management:''' bbermes, mpopova | ||
=== Mailing list === | === Mailing list === |