updated scripts with more comments