Update auth documentation

**Problem**
When working with hooks, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

No file or test is named. Start by locating the authentication hook documentation and the current hook error-handling entry point, then determine which messages need clarification; done means the relevant documentation and error messages clearly support debugging and maintenance.

Written by the indexing model from the issue text.