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?
:thumbsup: . I'll merge this for now.