added notes on the scripts