updated readme docs and comments