typo and structure fix
add auth docs; other fixes