make it easier for folks to start contributing

Signed-off-by: Markus Gattol <[email protected]>

README.rst

@@ -88,3 +88,25 @@ So, please feel free to sprinkle some of this around your systems and
 let the deliciousness come forth.
 
 .. _`Apache 2.0 licence`: http://www.apache.org/licenses/LICENSE-2.0.html
+
+Contribute
+==========
+This world is not salty enough yet... help us make it a saltier place:
+
+* install gitflow e.g. aptitude install git-flow on Debian or from source https://github.com/nvie/gitflow
+* fork the salt repository to you your github account
+* git clone [email protected]:<youraccount>/salt.git
+* cd salt; ./setuprepo.sh
+
+Start contributing... write a test, make sure the test fails, write
+the actual code, make the test pass and if it does, make an atomic
+commit (referencing the issue(s) if this is a fix) and git push to
+your fork. Issue a pull request so one of the saltstack members can
+review it and accept or require/advice a change. Lather, rinse,
+repeat...
+
+* git pull upstream develop
+* write the test, make it fail...
+* pep8, pylint, pychecker
+* commit, push
+* pull request

setuprepo.sh

@@ -0,0 +1,28 @@
+# run this script right after you cloned/forked the repo
+
+which git-flow 2>/dev/null
+has_gitflow=$?
+if [ ${has_gitflow} -gt 0  -a ! -x /usr/lib/git-core/git-flow ]; then
+  echo
+  echo "*************************************"
+  echo
+  echo "You need gitflow to hack on salt"
+  echo " - https://github.com/nvie/gitflow"
+  echo " - aptitude install git-flow"
+  echo
+exit 1
+fi
+
+git checkout master
+git remote add upstream https://github.com/saltstack/salt.git
+git config push.default tracking          # only push the current branch
+git config branch.autosetuprebase always  # we want a linear history
+
+echo "Configuring gitflow for this repository..."
+git flow init -d
+echo
+echo "gitflow has been setup successfully!"
+echo "See Contribute section at https://github.com/saltstack/salt for further information"
+
+git checkout develop
+git push -u origin develop