DOC - clean up example text, move note to pull request discussion.