fix a bunch of typos in the documentation
Fixing dead link to documentation in README.rst

Current link works as of June 9th, 2014.
Merge pull request #341 from apetresc/patch-1

Fixing dead link to documentation in README.rst
Merge pull request #230 from p1otr/master

documentation typos