readme docs cleanups and updates

Signed-off-by: Rick Waldron <waldron.rick@gmail.com>