diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0eeed66..5b9402b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,37 +2,71 @@ # Contributing to Fisherman -If you are looking for ways to help, peruse the [open issues][issues]. If you are already working on something, feel free to send us a PR. +If you are looking for ways to help, peruse the [open issues][issues] or send us your PR if you are already working on something. ## Guidelines * Fork the repo and create your feature branch from master. -* Test before you push. Get familiar with [Fishtape][fishtape]. +* If you make significant changes, please add tests too. Get familiar with [Fishtape][fishtape]. -* If you've changed APIs, update the documentation. +* If you've changed APIs, please update the documentation. -* Follow the [seven rules][commits] of a great git commit message. +* Follow the [seven rules][rules] of a great git commit message. ## Plugins -Third-party plugins are essential for keeping this project exciting. To learn how to create your own plugins and other extensions see `fisher help plugins`. +The fastest way to create a plugin is using the `scaffold` plugin. + +1. Install + + ```fish + fisher install scaffold + ``` + +2. Create a new plugin using the default template. + > See the `fisher help scaffold` for other usage instructions. + + ```fish + fisher scaffold + ``` To browse the available content use `fisher search` or browse the [Fishery][fishery]. -:anchor: +To submit a new plugin to the [index][index], use the `submit` plugin. + +1. Install + + ```fish + fisher install submit + ``` + +2. Submit + + ```fish + fisher submit my_plugin + ``` + +## Translations + +If you would like to translate a portion of the documentation, you can begin with the [Quickstart Guide][quick-start]. Use any of the existing translations as a reference to get started. -[slack-link]: https://fisherman-wharf.herokuapp.com/ -[slack-badge]: https://img.shields.io/badge/slack-join%20the%20chat-00B9FF.svg?style=flat-square +[slack-link]: https://fisherman-wharf.herokuapp.com/ +[slack-badge]: https://img.shields.io/badge/slack-join%20the%20chat-00B9FF.svg?style=flat-square -[issues]: https://github.com/fisherman/fisherman/issues?q=is%3Aopen+is%3Aissue -[commits]: http://chris.beams.io/posts/git-commit/#seven-rules +[rules]: http://chris.beams.io/posts/git-commit/#seven-rules +[issues]: https://github.com/fisherman/fisherman/issues?q=is%3Aopen+is%3Aissue [fishtape]: https://github.com/fisherman/fishtape -[fishery]: https://github.com/fishery +[index]: https://github.com/fisherman/fisher-index +[fishery]: https://github.com/fishery + + + +[quick-start]: https://github.com/fisherman/fisherman/wiki/Quickstart-Guide