Update/cleanup of documentation
Merge branch 'more-readme-improvements'