updating the readme.md to reflect the new script.
adding some comments on the script