updated docs, typos and some changes.
Merge pull request #143 from Tieske/gh-pages

updated docs, typos and then some.