There are many ways you can contribute:
- Reporting bugs
- Suggesting enhancements
- Improving documentation
- Submitting pull requests
Bugs are tracked as GitHub issues. Create an issue and provide the following information:
- A clear and descriptive title
- A detailed description of the issue
- Steps to reproduce the behavior
- Expected behavior
- Additional context (if any - stacktraces, screenshots, etc)
Enhancement suggestions are also tracked as GitHub issues. When suggesting an enhancement:
- Use a clear and descriptive title
- Provide a detailed description of the proposed feature
- Explain why this enhancement would be useful to most users
- Provide examples to demonstrate the desired behavior
Pull requests are welcome. Here's how to get started:
- Fork the repository.
- Create a new branch:
git checkout -b my-new-feature
. - Get the project running by executing
bin/setup
. - Make your changes & add tests.
- Run
bundle exec rake
to ensure all tests and Rubocop checks pass. - Commit your changes:
git commit -am 'Add some feature'
. - Push to the branch:
git push origin my-new-feature
. - Submit a pull request.
Ask for help if you need it!
Every pull request will go through a code review process. The review may ask for changes before merging. This is a normal part of the process; it ensures that all contributions are of high quality and align with the project's standards.
Documentation is the lifeblood of open source, so there are always opportunities to make it better. If you have suggestions or find errors:
- Open an issue or
- Submit a pull request with improvements
If you have any questions, feel free to create an issue or contact us directly.