I gave a talk recently at the Cleveland Python Meetup on pydoc. Here is the notebook explaining it all: https://github.com/CLEpy/CLEpy-MotM/blob/master/pydoc/pydoc.ipynb