update the readme to only point at the docs

Of the 12 links that are in the current readme for docs, 6 are 404s;
prevent this by not linking to individual sections.

Also mention how to read the docs if you've reading a git checkout's readme
Merge pull request #22 from jippi/feature/update-readme

update the readme to only point at the docs