updated readme, cleaned comments and fixed run.sh