What is the best way to create high quality API documentation for a python module implemented with PyO3?

[DanielT]

I've implemented a Python module using PyO3: autosar-data
That worked great, using PyO3 is a pleasure.

However the documentation was written by hand in markdown (it is rendered by mkdocs).
I'm not really satisfied with it, at least compared to the high standard set by rustdoc for rust documentation.

• It is written by hand instead of derived (somehow) from the implementation
• there are no doctests
• the formatting is not great (this is might just a be skill issue, if I'm using mkdocs incorrectly)

I would appreciate any suggestions that improve any or all of these points.