Update lib documentation

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

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

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

Start by locating the lib documentation and the route-related error-handling entry points; the issue names no specific file or test. Compare the current route errors with the requested debugging context, then update the documentation and verify that the resulting messages are more descriptive.

Written by the indexing model from the issue text.