added readme and made script a little nicer
changes discussed during Code Review
new files discussed during Code Review