Improve the README and fix a doc glitch (bugs #1 and #2)

BUG=
R=sethladd@google.com

Review URL: https://codereview.chromium.org/693753003