document, near the top, advice to developers for writing code:

	  - put the interesting argument at the end of the parameter list
