Thanks for taking an interest in this project. We want to make contributing to this project as easy and transparent as possible, whether it is:
- Reporting a bug
- Discussing the current state of the code
- Submitting a fix
- Proposing new features
- Becoming a maintainer
We use Github to host code, to track issues and feature requests, as well as accept pull requests. Discussion and general support is typically done through Discord and/or Email.
We Use Git Flow
All code changes happen through pull requests and are the best way to propose changes to the codebase. We actively welcome your pull requests:
- Fork the repo and create your own branch off of the
develop
branch. - Name your branch
feature/<name>-<hash>-<desc>
where:
<name>
is your Github username<hash>
is equal toprintf "%x\n" (date +"%H%M%S")
<desc>
is a short description using hyphen as a separator
- If you have added code that should be tested, add tests.
- If you have changes APIs, update the documentation.
- Ensure it passes whatever tests are being used.
- Make sure your code lints.
- Issue the pull request!
We use Github issues to track public bugs and feature requests. Report a bug/feature by opening a new issue; it is that easy!
In short, when you submit code changes, your submissions are understood to be under the same license that covers the project itself. If you have a concern about this, please refrain from submitting a PR and contact a maintainer directly.