updated scripts and readme files with additional documentation