X-Git-Url: http://git.kaliko.me/?a=blobdiff_plain;f=doc%2Fsource%2Fcontribute.rst;fp=doc%2Fsource%2Fcontribute.rst;h=cf87c1c417b17ac7e5bfcfadfe329d4c3e1f1a24;hb=966e3a848b9d545530cc7c7a78c5185c69183b22;hp=0000000000000000000000000000000000000000;hpb=f3611c77b044f33571434326abb8ad0485bf6278;p=python-musicpd.git

diff --git a/doc/source/contribute.rst b/doc/source/contribute.rst
new file mode 100644
index 0000000..cf87c1c
--- /dev/null
+++ b/doc/source/contribute.rst
@@ -0,0 +1,33 @@
+Contributing
+=============
+
+Use git, `learn if needed`_.
+
+Git Workflow
+-------------
+* ``master`` branch holds latest stable|release code
+* ``dev`` branch holds current development code
+* Work on a dedicated branch starting off ``dev``
+* I like fast forward merges, **please rebase on** ``dev`` **branch**
+* Advertise your work (cf. Note)
+
+.. NOTE::
+    **Git merge Workflow** |br|
+    I currently don't care about a specific workflow concerning changes submission. |br|
+    gitlab merge request, gh pull request, plain email pointing out a repo/ref. All we need is a public git repo and a ref to fetch from as long you rebased on ``dev`` branch.
+
+Coding
+-------
+
+* follow pep8
+* write unittest
+* actually test your code (unit and functional testing)
+
+
+.. _`learn if needed`: https://git-scm.com/book/
+
+.. |br| raw:: html
+
+    <br />
+
+.. vim: spell spelllang=en