Great to have you here. Here are a few ways you can help make kepler.gl even better!
When committing code, kepler.gl requires Developer Certificate of Origin (DCO) process to be followed.
The DCO is a lightweight way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project. Here is the full text of the DCO, reformatted for readability:
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.
Contributors sign-off that they adhere to these requirements by adding a Signed-off-by line to commit messages.
--signoffcommand line to append this automatically to your commit message:
$ git commit -s -m 'This is my commit message'
We are trying to keep our Github page for issues, bugs and feature requests only. You've got much better chances of getting supports on Stack Overflow. Many people including our engineers are ready to answer questions on Stack Overflow. Your question might already been answered there.
If you find a bug, you can help us by submitting an Issue to our GitHub Repository. Please use the github Bug Report Template and fill in as much as information as possible. Even better, you can submit a Pull Request with a fix.
If you want to contribute or add new features, please use Issue on github projects to start a new discussion using the Feature Request Template. If this receive a Go ahead, you can submit your patch as PR to the repository.
If you would like to implement a new feature then consider what kind of change it is:
- Pick your item Pick an item to execute
- Claim the item Reply in the ticket linked in the roadmap to claim the item, one of the member of the technical team will respond
- Major Changes that you wish to contribute to the project should be discussed first in an[GitHub issue][github-issues] that clearly outlines the changes and benefits of the feature.
- Small Changes can directly be crafted and submitted to the GitHub Repositoryas a Pull Request. See the section about Pull Request Submission Guidelines, andfor detailed information the core development documentation.
- Let's review your code Create a pull request
User Guides and API Docs are saved in the docs folder on Github. Help us improve documentation here by submitting a Pull Request.
First, follow the development documentation for detailed guidance on environment setup, code style, testing and commit message conventions.
- Search GitHub for an open or closed Pull Requestthat relates to your submission. You don't want to duplicate effort.
- Make your changes in a new git branch:
$ git checkout -b my-fix-branch master
- Create your patch commit, including appropriate test cases.
- Commit your changes using a descriptive commit message that follows ourcommit message conventions. Adherence to the conventions is required, because release notes are automatically generated from these messages.