Contributing Back to OpenGamma
OpenGamma welcomes contributions from other developers and users of the system.
The bug tracking and feature request system (Jira) is publicly available. We also welcome input on documentation, new components and code changes. Frequently, an issue will be discussed first on the forums and then be raise as a bug or feature request.
Contributing code
First, you need to fork the main OpenGamma Platform repository on github and learn how to build and test the system. We require this so that we can track why particular code went into the system, and what code went into resolving Jira issues.
There are certain standards that we require before accepting code however:
- Your code must have appropriate documentation. While our code style doesn't rely on extensive and unnecessary documentation, we do insist that things like interfaces have documentation.
- Your code must meet the OpenGamma formatting standards. All of our code has one formatting standard for readability, and we insist that all contributions match that standard.
- Your code must match our testing standards. We insist that:
- All code has appropriate, automated testing to ensure that the code works appropriately; and
- All tests are clean.
IP assignment
All major contributions require an IP assignment agreement to OpenGamma. This allows commercial customers receive a commercial license to the OpenGamma Platform, and that we have the legal authority to release the code under such a license. However, our IP assignment agreement has an embedded license back to you to allow you to do whatever you like with your contribution. Combined with the Apache v2 license, this means contributing is positive to both parties.