FIX Readme edits

Added comments to the config examples as well as a link to the Opauth docs.
Moved an FAQ item.
Minor formatting.
Added more links to Opauth Docs
NEW Documentation

Making a start to the documentation and cleaning up the README.md