https://pythonhosted.org/an_example_pypi_project/sphinx.html#auto-directives
I'm not suggesting that we drop everything and fix all the docstrings
right now but I am suggesting that we start following the sphinx
docstring format for new code and fix other-formatted docstrings as we
come across them.
Any objections?
Well, my only objection is, that the Sphinx format has IMHO the worst impact on how
docstrings look.
Maybe it is just me, but I use help() more often than html docs.
But other than that, I have no issues.
J.