updated notes and run.sh script