more explicit readme
more comments & documentation