improved formatting, fixed typos
Merge branch 'hotfix/fix-readme'