readability edits, some cleanup
improved example use