updated README and comments in scripts