Add better documentation for resource.persist and it's internal options

[Marak]

Users should be aware of the various options that can get passed into resource.persist, such as host, port, username, password, etc... based on the type of datasource being used.

[jfhbrook]

I added an example here c9e4dca

(that couch and account both exist so this example should work on copy-paste)