Cleaning up docs, and adding example to answer johnkpauls Q