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?
@jacobpgn - fix me!