Add git workflow and glossary

docs/git_workflow.rst

@@ -0,0 +1,21 @@
+Git workflow
+============
+
+This workflow describes the process of adding code to the repository.
+
+#. Describe what you want to achieve in an issue.
+#. Pull the master to get up to date.
+
+    #. ``git checkout master``
+    #. ``git pull``
+
+#. Create a new local branch with ``git checkout -b <name-for-your-branch>``.
+   It can make sense to prefix your branch with a description like ``feature`` or ``fix``.
+#. Solve the issue, most probably in several commits.
+#. Push your branch to github with ``git push origin <name-for-your-branch>``.
+#. Go to github and switch to your branch.
+#. Send a pull request from the web UI on github.
+#. After you received comments on your code, you can simply update your
+   pull request by pushing to the same branch again.
+#. Once your changes are accepted, merge your branch into master. This can
+   also be done by the last reviewer that accepts the pull request.

docs/glossary.rst

@@ -0,0 +1,12 @@
+
+Glossary
+========
+
+Glossary for mathematical terms
+-------------------------------
+
+Spherical Harmonic power spectrum [Tishby (2017) 3.1 Experimental setup]
+    ???
+
+O(3) rotations of the sphere [Tishby (2017) 3.1 Experimental setup]
+    ???

docs/index.rst

@@ -6,9 +6,23 @@
 Welcome to Deep Bottleneck's documentation!
 ===========================================
 
+A short restructeredText `reference <https://github.com/ralsina/rst-cheatsheet/blob/master/rst-cheatsheet.rst>`_.
+There is also a longer `video tutorial <https://www.youtube.com/watch?v=hM4I58TA72g>`_
+
+This is just to demonstrate latex.
+
+.. math::
+
+   (a + b)^2 = a^2 + 2ab + b^2
+
+   (a - b)^2 = a^2 - 2ab + b^2
+
 .. toctree::
    :maxdepth: 2
-   :caption: Contents:
+   :caption: Contents
+
+   glossary
+   git_workflow