doc formatting improvements

[chrisdicaprio]

The class API documentation is difficult to read due to font size and indentation defaults in mkdocs. For example:

• The "FUNCTIONS" header in the main body is smaller than a function "Returns" table. Should stand out to be easy to find.
• The function names are in a smaller font than the docstring for the function
• In the TOC (right column) the "Attributes" and "Functions" sections don't stand out from the attribute and function names making them hard to find. The hierarchy is lost.

[chrisbc]

@chrisdicaprio looking at the example here https://mkdocstrings.github.io/python/ there's some indentatino and styling things that might help with this issue (and which somehow we don't have in our setup)...