Improve documentation of the library

Also deprecate some unneccessary methods