Submitting patches to Haiku
Haiku uses Gerrit to handle patches for review. Patches are usually submitted from the command line using git. Initially, all your patches must be reviewed in this way, but after a while, you may be promoted to reviewer yourself and be granted the right to push your changes to the repository directly.
Since working with Gerrit is a bit different than the usual "pull request" flow some developers already know, please read our page about working with git for more details about the process.
Easy Introductory TasksHere are a few possible starting points:
- Fix font sensitivity issues and hard-coded values
Run apps, see if everything looks alright at different font sizes, fix any bugs. Check the source for use of hard-coded values (e.g., colors, paths) and use the respective API call to retrieve the system-defined value (e.g., via ui_color()).
- Make our UI and applications more compliant to our HIG
Run apps, check if menus and buttons are named and positioned correctly (e.g., menus/buttons that open a dialog should end with "..." using B_UTF8_ELLIPSIS). Also, check, for example, if the preferences dialogs apply changes immediately (or have an "Apply" button) and if they have a "Revert" button (instead of "Cancel" and "OK"). Also see if they behave consistently with the rest of our system preferences applications.
See the Human Interface Guidelines for further information on this item.
- Cleanup incompliant source files
We have Coding Guidelines that all of our source should follow (except for imported code from other projects). Some of the native applications do not follow these guidelines yet. Clean them up so they are compliant and submit a patch to our bug tracker as an enhancement ticket.
- Easy tasks from our bugtracker
Please also take a look at our list of easy tasks at the bugtracker. They are mostly smaller bugs that can be fixed by one person. Pick one of them, leave a comment that you are working on it and attach a patch when you're done.
If you don't find something for you in this list, please ask at our development mailing list by sending in a small introduction of yourself:
- What are your skills? - E.g.: "I'm a professional C++ developer." or "I'm a hobby coder with 2 years C++ experience."
- How many hour per week do you want to work? A rough estimate is enough, just so that we can assess which kind of task may fit you.
- Do you have experience with special development areas? - E.g.: kernel, network, file systems...
- Is there some specific area you want to work on?
When You've Found a TaskWhen you have found a task you'd like to work on, please feel free to ask your questions on the development mailing list. Before writing code please also read our Coding Guidelines and try to always keep them in mind (we are strict about them). Then we wish you much luck and fun coding for Haiku!
- Currently, Haiku is the best development environment. Linux, BSD, and OS X also work. BeOS, Zeta, Cygwin, and Solaris are no longer actively maintained as development environments and little to no support is offered for those platforms.
- Subscribe to these mailing lists:
- Learn which development tools are needed on your platform.
- Read how to get and build our source code.
- Learn the basics of our source tree layout.
- Get familiar with our project management and bug/issue tracking system (Trac).
- Learn our Coding Guidelines. All Haiku source code should comply to this standard.