Skip to content

Commit fdd3ecc

Browse files
committed
Add contributing docs
1 parent 9e786e3 commit fdd3ecc

File tree

2 files changed

+99
-1
lines changed

2 files changed

+99
-1
lines changed

CONTRIBUTING.md

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
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

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Documentation is hosted on [Github pages](https://thoughtbot.github.io/superglue
2727

2828
## Contributing
2929

30-
Thank you, [contributors]!
30+
See the [CONTRIBUTING] document. Thank you, [contributors]!
3131

32+
[CONTRIBUTING]: CONTRIBUTING.md
3233
[contributors]: https://github.com/thoughtbot/superglue_rails/graphs/contributors

0 commit comments

Comments
 (0)