update some utility scripts
documentation update