READY: cleanup and documentation

and lots of documentation