update README and comments