Pydoc doesn't parse docstrings at all. Most Python docstrings are written in reStructuredText (definitely the case for the scientific Python ecosystem). For example, here's pydoc's docs for ...

…nGH-115306) Pydoc no longer skips global functions implemented as builtin methods, such as MethodDescriptorType and WrapperDescriptorType.

A new project from Read the Docs aims to automatically generate API documentation from code uploaded to the Python Package Index Read the Docs, a popular community-supported service for creating ...