-
Notifications
You must be signed in to change notification settings - Fork 63
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Move Contributing section into dedicated document for better GitHub i…
…ntegration See https://github.com/blog/1184-contributing-guidelines.
- Loading branch information
Showing
4 changed files
with
48 additions
and
50 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,6 @@ | ||
--tag authenticated:"Requires Authentication" | ||
--markup markdown | ||
- | ||
CONTRIBUTING.md | ||
LICENSE.md | ||
README.md |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
## Contributing | ||
In the spirit of [free software][free-sw], **everyone** is encouraged to help improve this project. | ||
|
||
Here are some ways *you* can contribute: | ||
|
||
* by using alpha, beta, and prerelease versions | ||
* by reporting bugs | ||
* by suggesting new features | ||
* by writing or editing documentation | ||
* by writing specifications | ||
* by writing code (**no patch is too small**: fix typos, add comments, clean up | ||
inconsistent whitespace) | ||
* by refactoring code | ||
* by closing [issues][] | ||
* by reviewing patches | ||
|
||
## Submitting an Issue | ||
We use the [GitHub issue tracker][issues] to track bugs and features. Before | ||
submitting a bug report or feature request, check to make sure it hasn't | ||
already been submitted. When submitting a bug report, please include a [Gist][] | ||
that includes a stack trace and any details that may be necessary to reproduce | ||
the bug, including your gem version, Ruby version, and operating system. | ||
Ideally, a bug report should include a pull request with failing specs. | ||
|
||
## Submitting a Pull Request | ||
1. [Fork the repository.][fork] | ||
2. [Create a topic branch.][branch] | ||
3. Add specs for your unimplemented feature or bug fix. | ||
4. Run `bundle exec rake spec`. If your specs pass, return to step 3. | ||
5. Implement your feature or bug fix. | ||
6. Run `bundle exec rake spec`. If your specs fail, return to step 5. | ||
7. Run `open coverage/index.html`. If your changes are not completely covered | ||
by your tests, return to step 3. | ||
8. Add documentation for your feature or bug fix. | ||
9. Run `bundle exec rake yard`. If your changes are not 100% documented, go | ||
back to step 8. | ||
10. Add, commit, and push your changes. | ||
11. [Submit a pull request.][pr] | ||
|
||
[free-sw]: http://www.fsf.org/licensing/essays/free-sw.html | ||
[issues]: https://github.com/rubygems/gems/issues | ||
[gist]: https://gist.github.com/ | ||
[fork]: http://help.github.com/fork-a-repo/ | ||
[branch]: http://learn.github.com/p/branching.html | ||
[pr]: http://help.github.com/send-pull-requests/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters