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?
@greysteil I went for {BILL_ID} in some cases where the bill id is part of the URL being requested - but now I'm thinking it may be better to use examples throughout! I'll make this consistent tomorrow.