documenation

updated readme and comments