added explanations to the run script