Skip to content

Latest commit

 

History

History
53 lines (37 loc) · 2.16 KB

CONTRIBUTING.md

File metadata and controls

53 lines (37 loc) · 2.16 KB

Contributing

Every feedback is welcome!

Do not hesitate to:

  • Report bugs
  • Open discussions around the current state of the code
  • Request new features
  • Submit fixes/improvments

everything happen through Github, use Issues/Pull requests features.

See the Github Flow.

Pull requests

The best way to have a pull requested accepted is to:

  1. Fork the repo and create your branch from master
  2. If you've added code that should be tested, add tests
  3. If you've changed APIs, update the documentation
  4. Ensure the test suite passes
  5. Make sure your code lints ---------------------------------
  6. Issue that pull request!

Any contributions you make will be under the ISC Software License

In short, when you submit code changes, your submissions are understood to be under the same ISC License that covers the project. eel free to contact the maintainers if that's a concern.

Report bugs using Github's issues

We use GitHub issues to track public bugs. Report a bug by opening a new issue it's that easy!

Write bug reports with detail, background, and sample code

This is an example of a bug report I wrote, and I think it's not a bad model. Here's another example from Craig Hockenberry, an app developer whom I greatly respect.

Great Bug Reports tend to have:

  • A quick summary and/or background
  • Steps to reproduce
    • Be specific!
    • Give sample code if you can. My stackoverflow question includes sample code that anyone with a base R setup can run to reproduce what I was seeing
  • What you expected would happen
  • What actually happens
  • Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)

People love thorough bug reports. I'm not even kidding.

Use a Consistent Coding Style

Try to mimic the codebase style and run ormolu on each commit.

License

By contributing, you agree that your contributions will be licensed under its ISC License.