updated scripts to add more explanatory comments