updated readme and some code comments