CONTRIBUTING.md

January 24, 2018 ยท View on GitHub

Cookie Box is an open source project and we would love you to help us make it better.

Reporting Issues

A well formatted issue is appreciated, and goes a long way in helping us help you.

  • Make sure you have a GitHub account
  • Submit a Github issue by:
    • Clearly describing the issue
      • Provide a descriptive summary
      • Explain the expected behavior
      • Explain the actual behavior
      • Provide steps to reproduce the actual behavior
      • Put application stacktrace as text (in a Gist for bonus points)
      • Any relevant stack traces

If you provide code, make sure it is formatted with the triple backticks (`).

At this point, we'd love to tell you how long it will take for us to respond, but we just don't know.

Pull requests

We accept pull requests to Cookie Box for:

  • Fixing bugs
  • Adding new features

Not all features proposed will be added but we are open to having a conversation about a feature you are championing.

Here's a quick guide:

  1. Fork the repo.

  2. Run the tests. This is to make sure your starting point works. Run HANAMI_ENV=test bundle exec hanami db prepare to create the test database. Tests can be run via bundle exec rspec

  3. Create a new branch and make your changes. This includes tests for features!

  4. Push to your fork and submit a pull request. For more information, see Github's pull request help section.

  5. Make sure you do not delete/update the existing cassettes as tests are dependent on them.

  6. Delete log/development.log and capybara-*.html.

At this point you're waiting on us. Expect a conversation regarding your pull request; Questions, clarifications, and so on.

How to install project

$ bundle install
$ bundle exec hanami db prepare
$ HANAMI_ENV=test bundle exec hanami db prepare
$ npm install
$ bundle exec rspec
$ bundle exec hanami s