misc readme update.
formatting.
Merge remote-tracking branch 'upstream/master'