update docs and clean up run scripts