added some documentation to 3 scripts