We want to make contributing to this project as easy and transparent as possible, whether it's:
- Proposing new features
- Reporting bugs
- Discussing the current state of the code
- Submitting code
This document outlines the process that should be followed by contributors in order to try and acomplish that goal.
We use GitHub to host the code, to track feature requests and bugs, as well as accept pull requests.
We use GitHub issues to track track feature requests and bugs. If you want to request a feature or report a bug, open a new issue choosing and filling the appropriate template; it's that easy! However, before opening a new issue, make sure that it won't be duplicated by browsing the already existing ones.
Pull requests are the way to propose changes to the code (we use GitHub flow). Please note that before submitting any pull request there should be an issue where we can discuss about the changes to be implemented. Once we have agreed on what should be done, we actively welcome your pull requests:
- Fork the repository and create your branch from
master
- Name the branch following the
issueNumber-short-description
format (e.g.123-add-cool-feature
)
- Name the branch following the
- If you've added code that should be tested, add tests
- If you've made changes that should be documented, update the documentation
- Ensure the test suites pass
- Make sure your code lints
- Submit that pull request!
- Make sure to mention the related issue with appropriate keywords on the pull request description (e.g.
Fixes #123
)
- Make sure to mention the related issue with appropriate keywords on the pull request description (e.g.
When you submit code changes, your submissions are understood to be under the same AGPL-3.0 License that covers the project. Feel free to contact us at [email protected] if that's a concern.