rewrite the first script and move it to bin/
fix links in docs
more stuff in the README