Script improvements and some documentation in the README