enhancements for newbies

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

added additional examples
Merge pull request #1 from stevewasiura/patch-1

enhancements for newbies