doc: misc tweaks, new links, fix broken links

I read docs and wrote a crawler + link checker on the plane,
which also checks for #fragments. I'll send that out later
when it's less gross.

R=golang-dev, r
CC=golang-dev
https://codereview.appspot.com/8729050