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?
You use this convention here, but just example IDs elsewhere. Any reason, or should we be consistent?