bug fixes: 11711, 11695, 11271 (typos). Also added some info to README

BUG=
R=kathyw@google.com

Review URL: https://codereview.appspot.com/10739044