scripts are now better documented