API reference docs problems #234

I see a couple of problems with the API docs:

• The API reference wraps in the middle of the page
• Code snippets don't use monospace
• Not all return types exist in the function signature and sometimes they are manually added in the docstring (Type hinting overhaul. #219)