minor documentation fixes

split into 2 commits happen you want to CP the README.md one into the main branch