20140709 enhance documentation

* Elucidate some examples
* Explain the Client ID vs. App Key