Add prominent links to the API docs in README

Section headings in the README now link to the API documentation on godoc.org