document the new authentication customization options
fixes thanks to @WouterJ
clarify the authenticator type
add example on how to use the new SimplePreAuthenticatorInterface