Updating documentation and providing examples

The examples are trimmed down and edited from live files so hopefully
they aren't wrong.  I changed all the names for privacy.