Small readme tweaks
Deprecate the version one class methods
Docstrings for everyone