readme misc improvements

Jean Felder requested to merge wip/jfelder/readme-improvements into master May 14, 2020