update README and some code comments