updated README and comments in files