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.

Start by locating the utils documentation and the service error-handling entry points; the issue names no files or tests. Clarify which errors need improved messages, then update the relevant documentation and verify that service failures provide the requested debugging detail.

Written by the indexing model from the issue text.