How to generate an API reference like sklearn?

Question

To make a python package I am writing easier to use, I am thinking of making a detailed API documentation. The API reference of machine learning package sklearn is the one I am trying to emulate.

So what is the right tool to make such a documentation?

Answer 1

They use sphinx and extensions thereof. See the documentation section of the contributing guide, and the documentation makefile.