add comments and clean up a few scripts

fixes #11