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.