readability updates, fixes markdown errors
updated facets documentation
Merge pull request #10 from brennonyork/README-Hotfix

README Hotfixes