Clarify logic around authentication

:sparkles:  Now with documentation updates :sparkles: