2016-02-11 04:18:43 +00:00
|
|
|
[![Slack Room][slack-badge]][slack-link]
|
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
# Contributing
|
2016-01-01 21:12:40 +00:00
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
If you are looking for ways to help, browse [open issues][issues] or send us your PR if you are already working on something.
|
2016-01-01 21:12:40 +00:00
|
|
|
|
|
|
|
## Guidelines
|
|
|
|
|
|
|
|
* Fork the repo and create your feature branch from master.
|
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
* If you make significant changes, please add tests too. Get familiar with [Fishtape].
|
2016-01-01 21:12:40 +00:00
|
|
|
|
2016-02-13 09:51:33 +00:00
|
|
|
* If you've changed APIs, please update the documentation.
|
2016-01-01 21:12:40 +00:00
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
* Follow the [seven rules] of a great Git commit message.
|
2016-01-01 21:12:40 +00:00
|
|
|
|
2016-01-10 07:01:07 +00:00
|
|
|
## Plugins
|
2016-01-01 21:12:40 +00:00
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
1. Create a new plugin with `scaffold`.
|
|
|
|
```fish
|
|
|
|
fisher install scaffold
|
|
|
|
fisher scaffold
|
|
|
|
```
|
2016-02-13 09:51:33 +00:00
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
2. Submit a plugin to the [index] with `submit`.
|
|
|
|
```fish
|
|
|
|
fisher install submit
|
|
|
|
fisher submit my_plugin
|
|
|
|
```
|
2016-02-13 09:51:33 +00:00
|
|
|
|
|
|
|
## Translations
|
|
|
|
|
2016-02-29 14:13:29 +00:00
|
|
|
If you would like to translate a portion of the documentation, you can begin with the [Quickstart Guide].
|
2016-02-11 04:18:43 +00:00
|
|
|
|
2016-02-13 09:51:33 +00:00
|
|
|
[slack-link]: https://fisherman-wharf.herokuapp.com/
|
|
|
|
[slack-badge]: https://img.shields.io/badge/slack-join%20the%20chat-00B9FF.svg?style=flat-square
|
2016-02-29 14:13:29 +00:00
|
|
|
[seven rules]: http://chris.beams.io/posts/git-commit/#seven-rules
|
|
|
|
[open issues]: https://github.com/fisherman/fisherman/issues?q=is%3Aopen+is%3Aissue
|
|
|
|
[Fishtape]: https://github.com/fisherman/fishtape
|
2016-02-13 09:51:33 +00:00
|
|
|
[index]: https://github.com/fisherman/fisher-index
|
2016-02-29 14:13:29 +00:00
|
|
|
[Quickstart Guide]: https://github.com/fisherman/fisherman/wiki/Quickstart-Guide
|