Some grammatical corrections and markdown syntax fixes

It's tricky to commit changes with failing tests :)