enhancements for newbies

trying to add more explain to some functions. went as far as Line 350