Added more descriptive documentation for OAuth.

Per dialog in #640, here is a patch to robustify OAuth documentation.