IntersectMBO / IntersectMBO/govtool

💡Improve User-Friendly Error Messages in modals

Open
#3,107 1 comment 0 reactions 1 assignee Claimed by @m-i-k-e View on GitHub
🎨 Design Needed 💡 Feature idea
Dominant language
HTML
Stars
21
Forks
29
Avg merge
2d 22h
Merged PRs (30d)
7

Description

### Area

Proposal Pillar

### Is there new design needed?

Yes

### What?

Currently, error messages displayed to users in modals sometimes contain technical details or trace logs that are not meaningful to end users. This can lead to confusion and a poor user experience.

### Why?

- Improves user experience by providing clear, actionable messages.
- Reduces frustration by avoiding technical jargon.
- Helps users understand and resolve issues without requiring technical knowledge.
- Aligns with best practices for user communication.

### How?

- Review existing error messages across the application.
- Identify messages that contain stack traces, raw exceptions, or unclear technical terms.
- Replace these messages with clear, user-friendly descriptions.
- Ensure messages provide guidance on how to resolve the issue or where to get help.
- Maintain logging of technical details internally for debugging purposes without exposing them to users.

### (Optional) User Story with acceptance criteria

- [ ] All error messages presented to users are reviewed and updated where necessary.
- [ ] Error messages use clear, non-technical language.
- [ ] Messages provide actionable guidance where applicable.
- [ ] Internal logs still capture detailed technical errors for debugging.
- [ ] Changes are tested to ensure they appear correctly in the UI.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.