Google style or numpy style docstrings are easier to read in the source code than the "old" Sphinx style. In addition, these "new" docstring styles are supported OTB by the latest Sphinx.
http://sphinx-doc.org/ext/napoleon.html
http://sphinx-doc.org/ext/example_google.html