Documentation in the repo

I think it's better that we keep the authentication docs in the repo as opposed to the wiki that way people remember to edit it and we can comment + use version control on the docs.