vastly improve and clarify examples
minor, rename variable
minor, note to self