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 - this is actually convention in the library examples, Java being the exception. I'm going to go through the Java examples and make them all consistent with a placeholder instead of an example ID.