> I'm +1 to using sphinx-style docstrings but could likely be persuaded
> to use something different as long as it doesn't require too much
> custom code. We have enough custom tools as it is and I'd rather use
> something standard for api docs.
Yes, let's try use sphinx syntax in docstrings.
___
> > 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 docstri
> 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
>
