update the instructions on the index page
complete the readme for the scripts