aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjbranchaud <jbranchaud@gmail.com>2014-02-24 20:32:15 -0300
committerjbranchaud <jbranchaud@gmail.com>2014-02-25 15:59:57 -0300
commitb7d5edd5aa1c7e8958e35caf302451be3d3d931e (patch)
treef52e0058f3b4d8bfcb4498aef42c5229ea000934
parentf608d2361c2be9ea4f0c0b258f1b4f173d1004be (diff)
downloadrneovim-b7d5edd5aa1c7e8958e35caf302451be3d3d931e.tar.gz
rneovim-b7d5edd5aa1c7e8958e35caf302451be3d3d931e.tar.bz2
rneovim-b7d5edd5aa1c7e8958e35caf302451be3d3d931e.zip
Rebased the following three commits onto one another:
1. Following GitHub convention by adding a CONTRIBUTING.md file. 2. Linking to the wiki page for communicating. 3. Referencing the waffle.io page for Neovim.
-rw-r--r--CONTRIBUTING.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000000..e0202e5401
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,46 @@
+# Contributing to Neovim
+
+## Thank you
+
+Thanks for considering contributing to neovim. To make the process as smooth
+as possible we would ask you to follow the guidelines below.
+
+## Help with contributing
+
+See [Communicating](https://github.com/neovim/neovim/wiki/Communicating).
+Raise documentation issues.
+
+## Guidelines
+
+### Finding something to do
+
+Neovim uses [waffle.io](https://waffle.io/neovim/neovim), so check there
+first.
+
+You can also ask for an issues to be assigned to you.
+Ideally wait until we assign it to you to minimize
+work duplication.
+
+### Reporting an issue
+
+- Search existing issues before raising a new one.
+- Include as much detail as possible. In particular, we need to know which
+ OS you're using.
+
+### Pull requests
+
+- Make it clear in the issue tracker what you are working on, so that
+someone else doesn't duplicate the work.
+- Use a feature branch, not master.
+- Rebase your feature branch onto origin/master before raising the PR.
+- Keep up to date with changes in master so your PR is easy to merge.
+- Be descriptive in your PR message: what is it for, why is it needed, etc.
+- Make sure the tests pass (TODO: we need to make this easier with travis etc.)
+- Squash related commits as much as possible.
+
+### Coding style
+
+- Try to match the existing indent style. (TODO: specify)
+- Don't abuse the pre-processor.
+- Don't mix platform-specific stuff into the main code.
+- TODO: commit messages?