First of all, thank you for contributing!
For general questions or if you are having trouble getting started, try the
Google Genomics Discuss mailing list.
It's a good way to sync up with other people who use googlegenomics including the core developers. You can subscribe
by sending an email to google-genomics-discuss+subscribe@googlegroups.com
or just post using
the web forum page.
With Maven you can locally install a SNAPSHOT version of the code, to use from other projects directly without having to wait for the Maven repository. Use:
mvn install
to run the full tests and do a local install. You can also use
mvn install -DskipITs
to run only the unit tests and do a local install. This is faster.
If you are encountering a bug in the code or have a feature request in mind - file away!
If you are ready to contribute code, Github provides a nice overview on how to create a pull request.
Some general rules to follow:
- Do your work in a fork of this repo.
- Create a branch for each update that you're working on. These branches are often called "feature" or "topic" branches. Any changes that you push to your feature branch will automatically be shown in the pull request.
- Keep your pull requests as small as possible. Large pull requests are hard to review. Try to break up your changes into self-contained and incremental pull requests.
- The first line of commit messages should be a short (<80 character) summary, followed by an empty line and then any details that you want to share about the commit.
- Please try to follow the existing syntax style
When you submit or change your pull request, the Travis build system will automatically run tests. If your pull request fails to pass tests, review the test log, make changes and then push them to your feature branch to be tested again.
All pull requests are welcome. Before we can submit them though, there is a legal hurdle we have to jump. You'll need to fill out either the individual or corporate Contributor License Agreement (CLA).
- If you are an individual writing original source code and you're sure you own the intellectual property, then you'll need to sign an individual CLA.
- If you work for a company that wants to allow you to contribute your work, then you'll need to sign a corporate CLA.
Follow either of the two links above to access the appropriate CLA and instructions for how to sign and return it. Once we receive it, we'll be able to accept your pull requests.