a ton of fixes to docs
Merge pull request #266 from metamx/more-docs

a ton of fixes to docs