Adds additional example and clarifications
Adds additional example and clarifications

Thanks @jnthn for clarification, again. This closes #3553, again

MasterDuke17/doc,tbrowder/doc,MasterDuke17/doc,tbrowder/doc,tbrowder/doc,tbrowder/doc,MasterDuke17/doc,MasterDuke17/doc