rewrite documentation, clean up
updates
reflect changes
readme updated