update run.sh with comments for general use
minor changes to readme