User doc and readme corrections.

A quick pass at fixing up some typos in the docs.