Update utils documentation

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

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

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

The issue does not name a file, test, or entry point. Start by locating the utils documentation and the service error-handling code, then determine which messages need more detail. The work is done when the intended error cases have descriptive messages and the relevant documentation reflects the behavior.

Written by the indexing model from the issue text.