Errors explain and offer a way out
Say what failed, what is still safe, and one way forward (retry, edit or contact).
Draft — not yet reviewed by a maintainer
Why it matters
An error without its consequences leaves people worried about their work; one without an action leaves them stuck. Both lead to repeated attempts and support requests.
How to check it
Trigger each error: the text names the failure, the impact and an action.
The default it guards against
A red toast reading "Something went wrong" with no detail and no retry.
Library items that apply it
Where it comes from
- WCAG 2.2 SC 3.3.1 Error Identification (A)
- WCAG 2.2 SC 3.3.3 Error Suggestion (AA)
- Review dimension: task fit (docs/quality-gates.md)
Repository paths refer to the Tessli repository ; WCAG references are to WCAG 2.2.