improved README and run_script