readme updates
classes at top, and some docstrings