Fix #452 - update and improve docs

Added extra docs on auth providers, and updated README to fix missing bits, reorganize, etc.