Improve Python API Documentation

[gwenchee]

This issue can be closed when the following suggestion is implemented:

I'd recommend adding formatting to variable, function, and class names in the docstrings for your classes and functions so they render with styling and can be easily differentiated from normal text on the web-hosted API docs. This is a lot of work though so may be better suited for a new PR.

Originally posted by @yardasol in #53 (review)