updated readme and code comments