added comments, updated scripts/readme.md to be up-to-date