fixed some typos, tweaked the docs a bit
Merge pull request #813 from drdamour/yelp

fixed some typos, tweaked the docs a bit