README and comments update