Consistent and complete docstrings

[jeinarsson]

Make docstrings contain all necessary information and have consistent formatting. What is suitable?

---

• Bitbucket: https://bitbucket.org/goop/josync/issue/17
• Originally Reported By: Joel Goop
• Originally Created At: 2014-04-14T10:55:45.028

[joelgoop]

Chose to write "sphinxy" docstrings according to https://pythonhosted.org/an_example_pypi_project/sphinx.html#full-code-example

Done in d24ba25.