Skip to content

Files

Latest commit

 

History

History
51 lines (36 loc) · 2.01 KB

CONTRIBUTING.md

File metadata and controls

51 lines (36 loc) · 2.01 KB

Contributing

Input and contributions are very welcome! Please open issues with improvements, feature requests or bug reports. To contribute source code, add documentation or fix spelling mistakes try this:

  1. Fork a current branch (like master).
  2. Clone the forked git.
  3. Make changes and additions.
  4. Verify changes and make sure that the tests succeed.
  5. Add, commit, squash and push the changes to the forked repository.
  6. Send a pull request to Agavi

Please provide a well written issue describing the change and why it is necessary.

Coding styles

Please see the coding style hints before making changes and try to adhere to them.

Commit messages

Please use well-written commit messages. The basic format of git commit messages is:

  • A single short summary line of not more than 70 characters.
  • A blank line.
  • A detailed description of the change in present tense with not more than 80 characters per line.

License and credits

There is no Contributor License Agreement (CLA) to sign, but you have to accept and agree to the LICENSE to get your patches included. Make sure the contributions do not include code from libraries or projects with incompatible licenses. For a list of contributors see the github contributors graph.

Separate changes

Different independent logical changes should be separated into separate commits Separate patch submissions allow each change to be considered on it's own and make reviews a lot easier.

Tests

Commits are continously integrated via TravisCI and failing the PHPUnit tests will fail the builds. Usually the build status will be shown on the pull request by Github. If something fails please try to fix your changes as otherwise they can't be easily integrated by maintainers.