Housekeeping

cleaning up/adding whitespace, re-wording some examples