|
| 1 | +# Contributing to Superglue Rails |
| 2 | + |
| 3 | +We love pull requests from everyone. By participating in this project, you |
| 4 | +agree to abide by the thoughtbot [code of conduct]. |
| 5 | + |
| 6 | +[code of conduct]: https://thoughtbot.com/open-source-code-of-conduct |
| 7 | + |
| 8 | +Here are some ways *you* can contribute: |
| 9 | + |
| 10 | +* by using alpha, beta, and prerelease versions |
| 11 | +* by reporting bugs |
| 12 | +* by suggesting new features |
| 13 | +* by writing or editing documentation |
| 14 | +* by writing specifications |
| 15 | +* by writing code ( **no patch is too small** : fix typos, add comments, etc. ) |
| 16 | +* by refactoring code |
| 17 | +* by closing [issues][] |
| 18 | +* by reviewing patches |
| 19 | + |
| 20 | +[issues]: https://github.com/thoughtbot/superglue_rails/issues |
| 21 | + |
| 22 | +## Submitting an Issue |
| 23 | + |
| 24 | +* We use the [GitHub issue tracker][issues] to track bugs and features. |
| 25 | +* Before submitting a bug report or feature request, check to make sure it hasn't |
| 26 | + already been submitted. |
| 27 | +* When submitting a bug report, please include a reproduction script and any |
| 28 | + other details that may be necessary to reproduce the bug, including your gem |
| 29 | + version, Ruby version, and operating system. |
| 30 | + |
| 31 | +## Cleaning up issues |
| 32 | + |
| 33 | +* Issues that have no response from the submitter will be closed after 30 days. |
| 34 | +* Issues will be closed once they're assumed to be fixed or answered. If the |
| 35 | + maintainer is wrong, it can be opened again. |
| 36 | +* If your issue is closed by mistake, please understand and explain the issue. |
| 37 | + We will happily reopen the issue. |
| 38 | + |
| 39 | +## Submitting a Pull Request |
| 40 | + |
| 41 | +1. [Fork][fork] the [official repository][repo]. |
| 42 | +1. [Create a topic branch.][branch] |
| 43 | +1. Implement your feature or bug fix. |
| 44 | +1. Add, commit, and push your changes. |
| 45 | +1. [Submit a pull request.][pr] |
| 46 | + |
| 47 | +### Notes |
| 48 | + |
| 49 | +* Please add tests if you changed code. Contributions without tests won't be accepted. |
| 50 | +* If you don't know how to add tests, please put in a PR and leave a comment |
| 51 | + asking for help. We love helping! |
| 52 | +* Please don't update the Gem version. |
| 53 | + |
| 54 | +## Setting up |
| 55 | + |
| 56 | +Ensure you have cloned [props_template][props_template] in the parent directory: |
| 57 | + |
| 58 | +```sh |
| 59 | +cd .. |
| 60 | +git clone [email protected]:thoughtbot/props_template.git |
| 61 | +``` |
| 62 | + |
| 63 | +You can use the development `Gemfile` by |
| 64 | + |
| 65 | +```sh |
| 66 | +bundle install |
| 67 | +``` |
| 68 | + |
| 69 | +## Running the test suite |
| 70 | + |
| 71 | +Running unit tests: |
| 72 | + |
| 73 | +```sh |
| 74 | +bundle exec rake test |
| 75 | +``` |
| 76 | + |
| 77 | +Running acceptance tests: |
| 78 | + |
| 79 | +```sh |
| 80 | +ruby -Ilib:test test/acceptance/superglue_installation_acceptance.rb |
| 81 | +``` |
| 82 | + |
| 83 | +## Formatting |
| 84 | + |
| 85 | +Use [standard] to automatically format your code: |
| 86 | + |
| 87 | +```sh |
| 88 | +bundle exec rake standard:fix |
| 89 | +``` |
| 90 | + |
| 91 | +[repo]: https://github.com/thoughtbot/superglue_rails/tree/main |
| 92 | +[fork]: https://help.github.com/articles/fork-a-repo/ |
| 93 | +[branch]: https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/ |
| 94 | +[pr]: https://help.github.com/articles/using-pull-requests/ |
| 95 | +[standard]: https://github.com/testdouble/standard |
| 96 | + |
| 97 | +Inspired by https://github.com/middleman/middleman-heroku/blob/master/CONTRIBUTING.md |
0 commit comments