updates README and comments