fixed some typos and clarifying
Merge pull request #293 from carldunham/docfix

fixed some typos and clarifying