Status: To Do
Fix Version/s: None
Instead of writing type information in docstrings, we can use type annotations (which are inherently testable).
There are two Sphinx extensions that support PEP 484 type hints for functions parameters:
Although I won't confirm it as the optimal choice, https://github.com/agronholm/sphinx-autodoc-typehints seems to be a more active project.
Based on my reading, it seems that these projects are already compatible with tools that parse docstrings. The key is to add the sphinx_autodoc_typehints extension after both autodoc and a preprocessor like numpydoc or Napoleon.
I haven't yet confirmed that numpydoc works, though it should given that Napoleon does work.