[Enhancement]: Improve Error Messages for Storage-Related Failures with Actionable Solutions
- Dominant language
- Python
- Stars
- 562
- Forks
- 410
- Avg merge
- 22h 15m
- Merged PRs (30d)
- 197
Description
### Affected Area
Notifications/Alerts
### Problem Statement
The current error messages for storage issues only tell users what went wrong (e.g., "no space left on device") but don't provide instructions on how to fix it. Users are left without guidance on how to resolve the issue.
Current behavior:
Error shows: "Cannot complete backup: no space left on device"
User doesn't know what to do next
No cleanup suggestions or upgrade options provided
Expected behavior:
Error message includes actionable solutions
Links to relevant documentation
Alternative options like purging binlogs, clearing Docker images, or upgrading storage
Clear next steps for the user
ref: [](https://support.frappe.io/helpdesk/tickets/51041?view=VIEW-HD+Ticket-778)
### Proposed Solution
1. Display Error Banner on Top of Page
When storage errors occur, show a banner with:
- Clear error explanation
- Quick action buttons (Upgrade Storage, View Cleanup Guide)
- Dismissible option
2. Add "Click Here" Links in Error Messages
Modify error messages to include direct links:
- Link to storage upgrade page
- Link to cleanup documentation
- Link to relevant help articles
3. Provide Multiple Solutions in Error
Primary: Upgrade storage [link]
Alternatives:
- Purge old binlogs (command provided)
- Clear Docker images (command provided)
- Remove old backups (path provided)
Contributor guide
No contributing guide indexed for this repository
Research direction
Start by locating the storage-related failure messages and the Notifications/Alerts area described in the issue. Review how storage upgrades, cleanup guidance, binlog purging, Docker image cleanup, and old-backup removal can be linked or presented. Done means the agreed error flow provides clear next steps, relevant links, alternatives, and a dismissible banner where required.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, python
- Domain
- cloud, devops
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100