Updates from Help Errors Triggers group (#347)

jorycunningham · kfranqueiro · web-flow · commit cbabb0bfd868 · 2025-08-06T13:35:17.000-04:00
---------

Co-authored-by: Kenneth G. Franqueiro &lt;kfranqueiro@users.noreply.github.com&gt;
diff --git a/guidelines/groups/error-handling.json b/guidelines/groups/error-handling.json
@@ -1,5 +1,6 @@
 {
   "children": [
-    "correct-mistakes"
+    "correct-errors",
+    "prevent-errors"
   ]
 }
diff --git a/guidelines/groups/error-handling/correct-errors.md b/guidelines/groups/error-handling/correct-errors.md
@@ -0,0 +1,16 @@
+---
+children:
+  - error-association
+  - error-cause-association
+  - error-cause-in-notification
+  - error-identification
+  - error-linked
+  - error-location
+  - error-notification-label
+  - error-notification
+  - error-persists
+  - error-suggestion
+  - make-errors-distinct
+---
+
+Users know about and can correct errors.
diff --git a/guidelines/groups/error-handling/correct-errors/error-association.md b/guidelines/groups/error-handling/correct-errors/error-association.md
@@ -1,5 +1,6 @@
 ---
-status: exploratory
+status: developing
+type: supplemental
 ---
 
 Error notifications are :term[programmatically associated] with the error source so that users can access the error information while focused on the source of the error.
diff --git a/guidelines/groups/error-handling/correct-errors/error-cause-association.md b/guidelines/groups/error-handling/correct-errors/error-cause-association.md
@@ -0,0 +1,5 @@
+---
+status: developing
+---
+
+When an error occurs that results from a user interaction with an :term[interactive element] or component (aka a cause), the element or component is visually and programmatically associated with the trigger.
diff --git a/guidelines/groups/error-handling/correct-errors/error-cause-in-notification.md b/guidelines/groups/error-handling/correct-errors/error-cause-in-notification.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+When an error occurs that results from an :term[interactive element] or :term[component] (aka a cause), an indicator of the trigger is included in the error notification. If the interactive element or component is located in a different part of a process, then the page or step in the process is included in the error notification.
diff --git a/guidelines/groups/error-handling/correct-errors/error-identification.md b/guidelines/groups/error-handling/correct-errors/error-identification.md
@@ -1,5 +1,5 @@
 ---
-status: exploratory
+status: developing
 ---
 
 Errors are visually identifiable without relying on only text, only color, or only symbols.
diff --git a/guidelines/groups/error-handling/correct-errors/error-linked.md b/guidelines/groups/error-handling/correct-errors/error-linked.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+When an error notification is not adjacent to the item in error, a link to the error is provided.
diff --git a/guidelines/groups/error-handling/correct-errors/error-location.md b/guidelines/groups/error-handling/correct-errors/error-location.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+Error notifications are visually collocated with the item in error within the viewport, or provide a link to the source of the error which, when activated, moves the focus to the error.
diff --git a/guidelines/groups/error-handling/correct-errors/error-notification-label.md b/guidelines/groups/error-handling/correct-errors/error-notification-label.md
@@ -0,0 +1,9 @@
+---
+status: developing
+type: supplemental
+---
+
+Error notifications include text with at least two of the following:
+* Error notifications are identified with an error icon in text.
+* Error notifications use a color that differentiates the error from other content.
+* Error notifications are labeled with text that indicates its an error.
diff --git a/guidelines/groups/error-handling/correct-errors/error-notification.md b/guidelines/groups/error-handling/correct-errors/error-notification.md
@@ -1,5 +1,6 @@
 ---
-status: exploratory
+status: developing
+type: foundational
 ---
 
 Errors that can be automatically detected are identified and described to the user.
diff --git a/guidelines/groups/error-handling/correct-errors/error-persists.md b/guidelines/groups/error-handling/correct-errors/error-persists.md
@@ -1,5 +1,5 @@
 ---
-status: exploratory
+status: developing
 ---
 
-Error notifications persist until the user dismisses them or the error is resolved.
+Error notifications persist until the user dismisses them or the error is resolved.
diff --git a/guidelines/groups/error-handling/correct-errors/error-suggestion.md b/guidelines/groups/error-handling/correct-errors/error-suggestion.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: foundational
+---
+
+When an error occurs and suggestions for correction are known, then the suggestions are provided to the user, unless it would jeopardize the security or purpose of the content.
diff --git a/guidelines/groups/error-handling/correct-errors/make-errors-distinct.md b/guidelines/groups/error-handling/correct-errors/make-errors-distinct.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+Use a culturally relevant and familiar error symbol, color, and text to indicate errors.
diff --git a/guidelines/groups/error-handling/correct-mistakes.md b/guidelines/groups/error-handling/correct-mistakes.md
diff --git a/guidelines/groups/error-handling/correct-mistakes/visible-errors.md b/guidelines/groups/error-handling/correct-mistakes/visible-errors.md
diff --git a/guidelines/groups/error-handling/prevent-errors.md b/guidelines/groups/error-handling/prevent-errors.md
@@ -0,0 +1,12 @@
+---
+children:
+  - submission-confirmation
+  - validate-after-data-entry
+  - validate-as-you-go
+type: foundational
+---
+
+When users are submitting information, at least one of the following is true:
+* Users can review, confirm, and correct information before submitting
+* Information is validated and users can correct any errors found, or
+* Users can undo submissions.
diff --git a/guidelines/groups/error-handling/prevent-errors/submission-confirmation.md b/guidelines/groups/error-handling/prevent-errors/submission-confirmation.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+When users submit information as part of a process, users are notified that submission was completed and what information was provided.
diff --git a/guidelines/groups/error-handling/prevent-errors/validate-after-data-entry.md b/guidelines/groups/error-handling/prevent-errors/validate-after-data-entry.md
@@ -0,0 +1,6 @@
+---
+status: developing
+type: supplemental
+---
+
+During data entry, ensure data validation occurs after the user enters data.
diff --git a/guidelines/groups/error-handling/prevent-errors/validate-as-you-go.md b/guidelines/groups/error-handling/prevent-errors/validate-as-you-go.md
@@ -0,0 +1,8 @@
+---
+status: developing
+type: supplemental
+---
+
+When completing a multi-step process, validation for errors is completed before the user moves to the next step in the process.  
+
+Techniques could include in line error handling as well as step by step validation.

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"children": [`
`3`		`- "correct-mistakes"`
	`3`	`+ "correct-errors",`
	`4`	`+ "prevent-errors"`
`4`	`5`	`]`
`5`	`6`	`}`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +status: developing
 +---
++
 +When an error occurs that results from a user interaction with an :term[interactive element] or component (aka a cause), the element or component is visually and programmatically associated with the trigger.