I'm trying to use reST-style docstrings, i.e. def foo(bar): """a method that takes a bar aram bar: a Bar instance :type bar: Bar Is there a standard way to document yields? I looked at https://www.sphinx-doc.org/en/master/usage/domains/python.html#info-field-lists, a-la this question [ https://stackoverflow.com/questions/5334531/python-documentation-standard-for-docstring ], but no luck. I'm imagining something like, :yields: transformed bars :yield type: Baz Continue reading...