Clean up and update docs

Clean up some formatting issues in doc sources
and smooth out some wording.

Change-Id: I2bb2c9a32d67b71deeb7fcc13fd6a2949b4e195b
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Address review comments

A few typos and other changes based on the comments
from reviewing the previous changeset.

Change-Id: I0457db3496997586ad8e0432eea3eeda1641fae8
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Merge pull request #213 from dhellmann/doc-cleanup

Clean up and update docs