Improve wording and correct some examples

@greysteil Mostly just fixing things that have been over-enthusiastically copy-pasted and making some sentences clearer - could you review please?
Needs a `,`