Skip to content

Latest commit

 

History

History
61 lines (44 loc) · 2.73 KB

CONTRIBUTING.rst

File metadata and controls

61 lines (44 loc) · 2.73 KB

How to contribute

First of all, thank you for contributing!

The mailing list

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 [email protected] or just post using the web forum page.

Submitting issues

If you are encountering a bug in the code or have a feature request in mind - file away!

Submitting a pull request

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.

Contributor License Agreements

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.