bunch of doc changes; Issues #181 #182
Merge pull request #207 from SuperCowPowers/update-docs

bunch of doc changes; Issues #181 #182