tidied external scripts, added slack variable, and updated docs