Update README

Fix some formatting, add syntax highlighting to the code example,
and add a note about why we're called "v1" instead of "master" or
"unstable" or some other more obvious default branch name.