The hipster contribution process is trying to be as simple as possible, so people are not afraid of contributing. We are using Github for code hosting and pull requests for integrating contributions. We aim to have zero to very minimal level of bureaucracy.
The process consists of:
- First, it is advised to create a bug or feature on the issue tracker describing what you want to achieve. New contributions won't be rejected because of non-existing issue.
If it's an existing component, please show consideration to anyone who's previously updated the component (check
git logfor all source) by subscribing them to the issue.
- Sign up to Github
- Fork oi-userland within Github so you have your own copy to push to.
oi-userlandfrom your Github fork so you have a workspace locally in your development environment (which may be prepared according to instructions like these: Building in zones, How To Build illumos and Working on several bugs at once):
The target directory (
/code/oi-userlandin the example above) may exist but must be empty (non-existant is also okay). Apparently, the current user account must have write-rights to it.
- Make your changes, then
git commit, using the issue number and description from (1) above as the commit message.
- Push to Github
- Create Pull Request on Github and person with oi-userland commit rights will merge it. However, it also advised to email oi-dev
@openindiana.orgasking for a review if doing this for the first time or contributing some large changes. It is strongly advised to ask for review as other people might spot bugs you might oversee.
- Once the Pull Request is merged, hipster Jenkins instance will pick it up and build. If the build is completed successfully, the contribution will be pushed to the repository.