Browse files

Create the contributing file.

Something for potential contributors.
  • Loading branch information...
1 parent 9c29adf commit 1067ca0fc6bd965a2ac4bcfcc4052c7c7a4af0c2 @MartiUK MartiUK committed Oct 23, 2014
Showing with 38 additions and 0 deletions.
  1. +38 −0
@@ -0,0 +1,38 @@
+# How to contribute
+Unfortunately we all can't work on cmder every day of the year, so I have decided to write some guidelines for contributing.
+If you follow them your contribution will likely be pulled in quicker.
+## Getting Started
+* Fork the repository on GitHub (It's that easy)
+* Create a feature branch based on the development branch.
+## Making Changes
+* Make changes in your seperate branch.
+* Check for unnecessary whitespace with `git diff --check` before committing.
+* Make sure your commit messages are easy to understand
+* Squash your 'Correcting mistakes' commits if you have a lot of them. (See the 'Squashing Commits' link below)
+* Make sure your changes won't affect new users or user without a customised system, try out your changes on a fresh Windows VM to see if it would affect a new user's experience.
+ * Sometimes a change that helps you with your cmder experience and tools doesn't always mean other people may need/want it.
+## Making Trivial Changes
+### Documentation
+* If the documentation is about a currently available feature in cmder or correcting already created documentation, you can safely make your changes on the master branch and pull request them onto master.
+## Submitting Changes
+* Push your changes to the branch in your fork of the repository.
+* Submit a pull request to the develop branch of the cmder repository (unless it's a change in documentation [see above]).
+* Make sure you explicitly say to not complete the pull request if you are still making changes.
+# Additional Resources
+* [Squashing Commits](
+* [General GitHub documentation](
+* [GitHub pull request documentation](

0 comments on commit 1067ca0

Please sign in to comment.