added docstrings for all classes/functions; fixed some type hinting

[jbheard]

This will be a nice test of the new docs action and should kick off some decent code documentation.