summaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorAnish Athalye <me@anishathalye.com>2014-12-20 00:55:17 -0500
committerAnish Athalye <me@anishathalye.com>2014-12-20 00:55:17 -0500
commit2eb6353b16fae2e41efe4761979c70f3c8bc9d1b (patch)
tree1e9aa6909e104d0d582f11a2b3ef2397d0ebd919 /CONTRIBUTING.md
parentdde4644ee28040f8d25e380c5315edfd0e890276 (diff)
Add information on contributing
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md54
1 files changed, 54 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..44ffb16
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,54 @@
+Contributing
+============
+
+All kinds contributions to Dotbot are greatly appreciated. For someone
+unfamiliar with the code base, the most efficient way to contribute is usually
+to submit a [feature request](#feature-requests) or [bug report](#bug-reports).
+If you want to dive into the source code, you can submit a [patch](#patches) as
+well.
+
+Feature Requests
+----------------
+
+Do you have an idea for an awesome new feature for Dotbot? Please [submit a
+feature request][issue]. It's great to hear about new ideas.
+
+If you are inclined to do so, you're welcome to [fork][fork] Dotbot, work on
+implementing the feature yourself, and submit a patch. In this case, it's
+*highly recommended* that you first [open an issue][issue] describing your
+enhancement to get early feedback on the new feature that you are implementing.
+This will help avoid wasted efforts and ensure that your work is incorporated
+into the code base.
+
+Bug Reports
+-----------
+
+Did something go wrong with Dotbot? Sorry about that! Bug reports are greatly
+appreciated!
+
+When you [submit a bug report][issue], please include relevant information such
+as Dotbot version, operating system, configuration file, error messages, and
+steps to reproduce the bug. The more details you can include, the easier it is
+to find and fix the bug.
+
+Patches
+-------
+
+Before working on substantial changes to the code base, it is *highly
+recommended* that you first [open an issue][issue] describing what you intend
+to work on.
+
+**Patches are generally submitted as pull requests.** Patches are also
+[accepted over email][email].
+
+Any changes to the code base should follow the style and coding conventions
+used in the rest of the project. The version history should be clean, and
+commit messages should be descriptive and [properly
+formatted][commit-messages].
+
+If you have any questions about anything, feel free to [ask][email]!
+
+[issue]: https://github.com/anishathalye/dotbot/issues/new
+[fork]: https://github.com/anishathalye/dotbot/fork
+[email]: mailto:me@anishathalye.com
+[commit-messages]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html