Python package docs are gross

Not sure how to make this better, but the autodoc pukefest is neither enlightening nor helpful. How could we make this more useful for the average user?