added some clarity to the functions and what they do (and the work needed)