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