Add sphinx doc (closes #3)

[python-musicpd.git] / doc / source / contribute.rst

diff --git a/doc/source/contribute.rst b/doc/source/contribute.rst
new file mode 100644 (file)
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