updated README and comments