Updating documentation and idempotent scripts

adding readme and 3 idempotent script examples