updated readme and comments throughout code