Merge pull request #293 from carldunham/docfix

fixed some typos and clarifying