/points

A Rails application to collaboratively estimate stories

Primary LanguageRuby

Points Application

CircleCI Maintainability

This is a Rails application to collaboratively estimate stories

Getting started

To get started with the app, clone the repo and then install the needed gems running the setup script (NOTE: The version of bundler used is 2.2.26):

$ ./bin/setup

Environment Variables

ORGANIZATION_LOGIN=<INSERT-HERE>
GITHUB_APP_ID=<INSERT-HERE>
GITHUB_APP_SECRET=<INSERT-HERE>

GITHUB_APP_ID and GITHUB_APP_SECRET: You need to sign up for an OAuth2 Application ID and Secret on the GitHub Applications Page.

ORGANIZATION_LOGIN: This is the organization name as it appears in the Github URL, for instance “orgname’ in https://github.com/orgname. It is needed to check if users are a part of the organization. Ensure that your membership is set to public when you visit https://github.com/orgs/orgname/people.

Starting the Server

$ rails s

Go to http://localhost:3000

Running Tests

$ rails spec

Using Docker

NOTE: You'll need to have docker and docker-compose installed

Build the points docker image

$ docker-compose build

Setup database and run migrations

$ docker-compose run web rails db:setup

Run the app

$ docker-compose up

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/fastruby/points. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

When Submitting a Pull Request:

  • If your PR closes any open GitHub issues, please include Closes #XXXX in your comment

  • Please include a summary of the change and which issue is fixed or which feature is introduced.

  • If changes to the behavior are made, clearly describe what changes.

  • If changes to the UI are made, please include screenshots of the before and after.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Points project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Sponsorship

FastRuby.io | Rails Upgrade Services

Points is maintained and funded by FastRuby.io. The names and logos for FastRuby.io are trademarks of The Lean Software Boutique LLC.