Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
There are many ways to contribute to the project.
- Be active and helpful on the mailing list.
- Report bugs by creating issues on the tracker.
- The best way to report a bug is to create a failing test case. Please see the Contribute code section.
- Create a new feature or modification.
- Improve documentation. Documentations are placed under src/site directory in the xdoc format, so it is basically the same as creating a patch to contribute documentation changes. Please see the Contribute code section.
Copyright and License
- You are the author of your contributions and will always be.
- Everything you can find it this project is licensed under the Apache Software License 2.0
- Every contribution you do must be licensed under the Apache Software License 2.0. Otherwise we will not be able to accept it.
- Please make sure that all the new files you create hold the following header:
/* * Copyright [year] the original author or authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */
How to send your modifications as a pull request
The best way to submit a patch is to send a pull request.
Here are the steps of a typical workflow.
- Fork the repository on GitHub.
- Clone your fork to your local machine.
- Create a topic branch with a descriptive name.
- Make changes with unit tests in the topic branch.
- Push commits to your fork on GitHub.
- Send a pull request.
For how to write a unit test, please see the unit test page.