Added some doco to whet the appetite.

Generic, contrived use cases.  Covered pretty much all of the basics.  Even uncovered a bug while doing so.