From 3421d68513d1f8980f5ee6c89c013e79e551ec4e Mon Sep 17 00:00:00 2001 From: Bruno Pinto <brunoferreirapinto@gmail.com> Date: Fri, 30 Jan 2015 01:48:02 -0200 Subject: [PATCH] contributing guidelines --- CONTRIBUTING.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..34b82e5 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,37 @@ +# Contributing + +We love pull requests. Here's a quick guide. + +Fork and make your change. Make sure the tests pass: + + ./script/run-tests.fish -v + +Push to your fork and [submit a pull request][pr]. + +[pr]: https://github.com/bpinto/oh-my-fish/compare/ + +At this point you're waiting on us. We usually comment on pull requests +within a few hours. We may suggest some changes or improvements or alternatives. + +Some things that will increase the chance that your pull request is accepted: + +* Write tests. +* Follow our [style guide][style]. +* Write a [good commit message][commit]. + +## Style Guide + +* Indentation should follow the "2-space convention". +* Keep line length to a maximum of 100 characters. + +### Plugins + +If your plugin is complex, make sure to include tests, we suggest using [fish-spec](fish-spec). + +### Themes + +Make sure to include a screenshot in your pull request. A nifty way is too post a comment with the image and link directly to it. + +[fish-spec]: https://github.com/bpinto/oh-my-fish/tree/master/plugins/fish-spec +[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html +[style]: #style-guide -- GitLab