2016-05-25 10:07:03 -04:00
|
|
|
# Contributing
|
|
|
|
|
2016-05-25 14:02:12 -04:00
|
|
|
<!--lint disable alphabetize-lists-->
|
|
|
|
|
2016-05-25 10:07:03 -04:00
|
|
|
Your contributions are always welcome!
|
|
|
|
|
|
|
|
## Guidelines
|
|
|
|
|
2016-05-25 14:02:12 -04:00
|
|
|
- Add one link per commit.
|
|
|
|
|
|
|
|
- Add one commit per Pull Request.
|
|
|
|
|
|
|
|
- Add the link: `- [project-name](http://example.com/) - A short description ends with a period.`
|
|
|
|
|
|
|
|
- Keep descriptions concise.
|
|
|
|
|
|
|
|
- Add a section if needed.
|
|
|
|
|
|
|
|
- Add the section description.
|
|
|
|
- Add the section title to Table of Contents.
|
|
|
|
|
|
|
|
- Search previous suggestions before making a new one, as yours may be a duplicate.
|
|
|
|
|
|
|
|
- Check your spelling and grammar.
|
|
|
|
|
|
|
|
- Remove any trailing whitespace.
|
|
|
|
|
|
|
|
- Send a Pull Request with the reason why the library is awesome.
|
|
|
|
|
|
|
|
- Make sure the tests are passing.
|
|
|
|
|
|
|
|
## Styleguide
|
|
|
|
|
|
|
|
We enforce you all to use the same style for your submittions.
|
|
|
|
We are using [`remark-lint`](https://github.com/wooorm/remark-lint) to validate the style of the `README.md` and `CONTRIBUTING.md`.
|
|
|
|
|
|
|
|
Please, refer to [`Rules`](https://github.com/wooorm/remark-lint/blob/master/doc/rules.md) documentation, when in doubt.
|
|
|
|
|
|
|
|
## Testing
|
|
|
|
|
|
|
|
To run tests locally you will need:
|
|
|
|
|
|
|
|
- Ruby
|
|
|
|
- Node.js
|
|
|
|
|
|
|
|
To execute them:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
$ gem install awesome_bot
|
|
|
|
$ npm install
|
2016-05-25 14:05:18 -04:00
|
|
|
$ npm test && awesome_bot -f README.md -t 10 --allow-redirect
|
2016-05-25 14:02:12 -04:00
|
|
|
```
|