Spruce up the docs

Merged Bryan R requested to merge wip/b/readme-cleanup into master

Merge request reports