Add a more in-depth section in the docs covering authentication.

A detailed authentication section, this will be huge but I don't think we have a clear picture of how the different pieces really come together i.e. realms, domains, mappers and decoders and subsequently the authentication factories.