sjs/rack-attack
1
0
Fork 0
mirror of https://github.com/samsonjs/rack-attack.git synced 2026-04-27 15:07:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #331 from grzuy/contributing_doc

Browse source 
[Fixes #321] Provide some advice for users willing to contribute to the project
This commit is contained in:
Gonzalo Rodriguez 2018-03-30 15:47:56 -03:00 committed by GitHub
commit f995958f18
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 34 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
CONTRIBUTING.md Normal file
View file

@ -0,0 +1,16 @@
# Rack::Attack: Contributing
Thank you for considering contributing to Rack::Attack.
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Code of Conduct](CODE_OF_CONDUCT.md).
## How can I help?
Any of the following is greatly appreciated:
* Helping users by answering to their [questions](https://github.com/kickstarter/rack-attack/issues?q=is%3Aopen+is%3Aissue+label%3A%22type%3A+question%22)
* Helping users troubleshoot their [error reports](https://github.com/kickstarter/rack-attack/issues?q=is%3Aissue+is%3Aopen+label%3A%22type%3A+error+report%22) to figure out if the error is caused by an actual bug or some misconfiguration
* Giving feedback by commenting in other users [feature requests](https://github.com/kickstarter/rack-attack/issues?q=is%3Aissue+is%3Aopen+label%3A%22type%3A+feature+request%22)
* Reporting an error you are experiencing
* Suggesting a new feature you think it would be useful for many users
* If you want to work on fixing an actual issue and you don't know where to start, those labeled [good first issue](https://github.com/kickstarter/rack-attack/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) may be a good choice

21
README.md
View file

@ -402,26 +402,15 @@ less on short-term, one-off hacks to block a particular attack.
## Contributing ## Contributing
Pull requests and issues are greatly appreciated. This project is intended to be Check out the [Contributing guide](CONTRIBUTING.md).
a safe, welcoming space for collaboration, and contributors are expected to
adhere to the [Code of Conduct](CODE_OF_CONDUCT.md).
### Testing pull requests ## Code of Conduct
To run the minitest test suite, you will need both [Redis](https://redis.io/) and This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Code of Conduct](CODE_OF_CONDUCT.md).
[Memcached](https://memcached.org/) running locally and bound to IP `127.0.0.1` on
default ports (`6379` for Redis, and `11211` for Memcached) and able to be
accessed without authentication.
Install dependencies by running ## Development setup
```sh
bundle install
```
Then run the test suite by running Check out the [Development guide](docs/development.md).
```sh
bundle exec rake
```
## Mailing list ## Mailing list

13
docs/development.md Normal file
View file

@ -0,0 +1,13 @@
# Rack::Attack: Development
## Running the tests
You will need both [Redis](https://redis.io/) and [Memcached](https://memcached.org/) running locally and bound to IP `127.0.0.1` on default ports (`6379` for Redis, and `11211` for Memcached) and able to be accessed without authentication.
Install dependencies by running
$ bundle install
Then run the test suite by running
$ bundle exec appraisal rake test