Skip to content

Latest commit

 

History

History
68 lines (47 loc) · 2.49 KB

CONTRIBUTING.md

File metadata and controls

68 lines (47 loc) · 2.49 KB
Raw

OSSBoard 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 OSSBBoard 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

  1. register a new github OAuth application. You can do it here.
  2. register a new gitlab Personal Access Token. You can do it here.
  3. run this commands:
$ bundle install
$ npm install
$ bundle exec hanami db prepare
$ HANAMI_ENV=test bundle exec hanami db prepare
$ bundle exec rspec
$ GITHUB_KEY='your github key' GITHUB_SECRET='your github server' bundle exec hanami server

Troubleshooting

If you are using peer authentication and get password request, configure your pg_hba.conf to trust local ipv4 connections: host all all 127.0.0.1/32 trust