imporoved usability and clarity. updated readme.