{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/make-the-error-show-the-next-repair",
  "id": "MHC-D-RESEARCH-1104",
  "version": "0.1.0",
  "title": "Make the error show the next repair",
  "summary": "Invalid is a verdict, not an instruction.",
  "kind": "protocol",
  "body": "Connect the message to the affected field and explain the correctable problem in plain language. Preserve useful context so the user can repair the entry rather than restart blindly. Test what happens after correction as well as the first error.",
  "limits": [
    "Do not reveal private account information through detailed errors. Avoid blaming the user for network failures or conditions they cannot repair."
  ],
  "topics": [
    "accessible-workflows-50"
  ],
  "intents": [],
  "source_ids": [
    "RS-4EAE438AF6261A91"
  ],
  "evidence": [
    {
      "claim": "WAI guidance calls for errors to be identified and described so users can understand and correct them.",
      "source_id": "RS-4EAE438AF6261A91",
      "role": "supports",
      "note": "Error wording must not expose sensitive information or claim knowledge the system lacks.",
      "locator": "Error notifications and correction guidance."
    }
  ],
  "use_when": [
    "A form rejects input but leaves people guessing what to change."
  ],
  "avoid_when": [
    "Do not reveal private account information through detailed errors. Avoid blaming the user for network failures or conditions they cannot repair."
  ],
  "example": "Instead of Something went wrong, a form says that the end date precedes the start date and identifies the relevant field.",
  "check": "Can a user make a valid correction without a moderator translating the message?",
  "steps": [
    "Describe the specific problem the system can actually detect.",
    "Show where to fix it and give an example or constraint when useful.",
    "Submit a corrected value and check that the message and state update consistently."
  ],
  "sources": [
    {
      "id": "RS-4EAE438AF6261A91",
      "title": "User Notifications",
      "url": "https://www.w3.org/WAI/tutorials/forms/notifications/"
    }
  ],
  "relations": [
    {
      "from": "MHC-D-RESEARCH-1104",
      "to": "MHC-D-RESEARCH-1105",
      "type": "useful_with",
      "url": "/knowledge/announce-the-result-without-stealing-the-user-s-place"
    }
  ],
  "collections": [
    {
      "id": "RC-F151F4A278F577C4",
      "title": "Make the task usable across different ways of accessing it",
      "url": "/collections/make-the-task-usable-across-different-ways-of-accessing-it"
    }
  ]
}
