diff --git a/how-to/outcomes/error-notifications-described/activities/activities.json b/how-to/outcomes/error-notifications-described/activities/activities.json new file mode 100644 index 0000000..aeadf6c --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/activities.json @@ -0,0 +1,4 @@ +{ + "type": "activity", + "title": "Activity" +} \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-described/activities/design.md b/how-to/outcomes/error-notifications-described/activities/design.md new file mode 100644 index 0000000..b0e47c2 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/design.md @@ -0,0 +1,5 @@ +--- +subtitle: Design +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/activities/develop.md b/how-to/outcomes/error-notifications-described/activities/develop.md new file mode 100644 index 0000000..e8a7da6 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/develop.md @@ -0,0 +1,5 @@ +--- +subtitle: Develop +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/activities/edit.md b/how-to/outcomes/error-notifications-described/activities/edit.md new file mode 100644 index 0000000..41c567a --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/edit.md @@ -0,0 +1,5 @@ +--- +subtitle: Edit +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/activities/plan.md b/how-to/outcomes/error-notifications-described/activities/plan.md new file mode 100644 index 0000000..aa2a004 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/plan.md @@ -0,0 +1,5 @@ +--- +subtitle: Plan +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/activities/test.md b/how-to/outcomes/error-notifications-described/activities/test.md new file mode 100644 index 0000000..bae716a --- /dev/null +++ b/how-to/outcomes/error-notifications-described/activities/test.md @@ -0,0 +1,5 @@ +--- +layout: layout/test-activity.md +--- + + diff --git a/how-to/outcomes/error-notifications-described/error-notifications-described.11tydata.js b/how-to/outcomes/error-notifications-described/error-notifications-described.11tydata.js new file mode 100644 index 0000000..baddaa9 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/error-notifications-described.11tydata.js @@ -0,0 +1,3 @@ +module.exports = { + ...require('../../build/get-outcome')(__dirname) +} diff --git a/how-to/outcomes/error-notifications-described/examples.md b/how-to/outcomes/error-notifications-described/examples.md new file mode 100644 index 0000000..8b2264a --- /dev/null +++ b/how-to/outcomes/error-notifications-described/examples.md @@ -0,0 +1,5 @@ +--- +title: Examples +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/index.md b/how-to/outcomes/error-notifications-described/index.md new file mode 100644 index 0000000..eeb7edc --- /dev/null +++ b/how-to/outcomes/error-notifications-described/index.md @@ -0,0 +1,23 @@ +--- +title: Get Started +--- + +
+

{{ outcome.description }}

+
+ +## Summary + +Coming soon + +## Why + +Coming soon + +## Who it helps + +Coming soon + +## How + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/methods.md b/how-to/outcomes/error-notifications-described/methods.md new file mode 100644 index 0000000..d2d86cc --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods.md @@ -0,0 +1,5 @@ +--- +layout: layout/methods.md +--- + + diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/background.md b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/background.md new file mode 100644 index 0000000..35176bb --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/background.md @@ -0,0 +1,17 @@ +--- +subtitle: Background +--- + +Coming soon + +### Bibliography + +- [Coming soon](https://) + +### Assumptions + +- [Coming soon](https://) + +### Accessibility Support + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/clear-language-errors.json b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/clear-language-errors.json new file mode 100644 index 0000000..8a02180 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/clear-language-errors.json @@ -0,0 +1,8 @@ +{ + "method": { + "index": 1, + "title": "Explain the error in clear language", + "slug": "clear-language-errors", + "description": "" + } +} diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/code-snippets.md b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/code-snippets.md new file mode 100644 index 0000000..eb56b89 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/code-snippets.md @@ -0,0 +1,33 @@ +--- +subtitle: Code Snippets +--- + +### Passed + +#### Passed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Failed + +#### Failed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Inapplicable + +#### Inapplicable Example 1 + +Coming soon + +```html +Code snippet +``` diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/definitions.md b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/definitions.md new file mode 100644 index 0000000..93ee43b --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/definitions.md @@ -0,0 +1,5 @@ +--- +subtitle: Technical Definitions +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/index.md b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/index.md new file mode 100644 index 0000000..17bba6c --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/index.md @@ -0,0 +1,26 @@ +--- +subtitle: Introduction +--- + +* Discussion of how to handle a situation where there is only one Method. We agreed that if there are multiple methods, we can articulate which combinations of methods are satisfactory to meet the outcome, or it can be one outcome, one method. + +* When creating outcomes, there is an ongoing question about when to break apart outcomes and when to combine related requirements. The advantage of breaking outcomes apart is that separate outcomes raise awareness of needs and ensure critical parts are not hidden at lower levels of documentation. The disadvantage of creating separate outcomes is the sheer number of resulting outcomes which may feel overwhelming. Groups should remain aware of this tension and document the rationale for breaking outcomes apart. Conversely, combining outcomes as “outcome A and outcome B” may result in outcome B being overlooked + +### Summary + +Coming soon + +
+
+
Platform:
+
Any platform supporting HTML
+
+
+
Technology:
+
HTML
+
+
+ +### How it solves user need + +Coming soon \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-described/methods/clear-language-errors/test.md b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/test.md new file mode 100644 index 0000000..232d260 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/clear-language-errors/test.md @@ -0,0 +1,17 @@ +--- +subtitle: Test +--- + +1. Identify the type of error that has occurred + +2. Identify where the error has occurred + +3. The error message is written in clear language or has a link to a clear language explanation. “Error 10752” is a fail. + +### Applicability + +Coming soon + +### Expectation + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/methods/methods.json b/how-to/outcomes/error-notifications-described/methods/methods.json new file mode 100644 index 0000000..f25a945 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/methods/methods.json @@ -0,0 +1,3 @@ +{ + "type": "method" +} \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-described/outcome.json b/how-to/outcomes/error-notifications-described/outcome.json new file mode 100644 index 0000000..e8e0a7b --- /dev/null +++ b/how-to/outcomes/error-notifications-described/outcome.json @@ -0,0 +1,5 @@ +{ + "index": 0, + "title": "Notifications describe errors", + "description": "Provides a clear message describing the error so users understand the cause of the error." +} diff --git a/how-to/outcomes/error-notifications-described/resources.md b/how-to/outcomes/error-notifications-described/resources.md new file mode 100644 index 0000000..368fbda --- /dev/null +++ b/how-to/outcomes/error-notifications-described/resources.md @@ -0,0 +1,7 @@ +--- +title: Resources +--- + +## W3C Resources + +Coming soon diff --git a/how-to/outcomes/error-notifications-described/user-needs.md b/how-to/outcomes/error-notifications-described/user-needs.md new file mode 100644 index 0000000..bfe5e58 --- /dev/null +++ b/how-to/outcomes/error-notifications-described/user-needs.md @@ -0,0 +1,38 @@ +--- +title: User Needs +--- + +
+

{{ outcome.description }}

+
+ +## Barriers Encountered + +* No description of cause of error +* Unhelpful description of cause of error error +* Error description that is not understandable (e.g., not clear) + +## Common User Needs + +* Error message describes the error: User needs an error message describing the error so they know what went wrong. + +## Unique User Needs + +* N/A + +## Functional Needs + +* Essential +* Sensory - Vision and Visual +* Sensory - Sensory Intersections +* Cognitive - Attention +* Cognitive - Language and Literacy +* Cognitive - Learning +* Cognitive - Memory +* Cognitive - Executive +* Cognitive - Mental Health +* Cognitive - Cognitive and Sensory Intersections +* Independence +* Physical - Mobility +* Physical - Motor +* Physical & Sensory Intersections \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/activities/activities.json b/how-to/outcomes/error-notifications-provided/activities/activities.json new file mode 100644 index 0000000..aeadf6c --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/activities.json @@ -0,0 +1,4 @@ +{ + "type": "activity", + "title": "Activity" +} \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/activities/design.md b/how-to/outcomes/error-notifications-provided/activities/design.md new file mode 100644 index 0000000..b0e47c2 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/design.md @@ -0,0 +1,5 @@ +--- +subtitle: Design +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/activities/develop.md b/how-to/outcomes/error-notifications-provided/activities/develop.md new file mode 100644 index 0000000..e8a7da6 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/develop.md @@ -0,0 +1,5 @@ +--- +subtitle: Develop +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/activities/edit.md b/how-to/outcomes/error-notifications-provided/activities/edit.md new file mode 100644 index 0000000..41c567a --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/edit.md @@ -0,0 +1,5 @@ +--- +subtitle: Edit +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/activities/plan.md b/how-to/outcomes/error-notifications-provided/activities/plan.md new file mode 100644 index 0000000..aa2a004 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/plan.md @@ -0,0 +1,5 @@ +--- +subtitle: Plan +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/activities/test.md b/how-to/outcomes/error-notifications-provided/activities/test.md new file mode 100644 index 0000000..bae716a --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/activities/test.md @@ -0,0 +1,5 @@ +--- +layout: layout/test-activity.md +--- + + diff --git a/how-to/outcomes/error-notifications-provided/error-notifications-provided.11tydata.js b/how-to/outcomes/error-notifications-provided/error-notifications-provided.11tydata.js new file mode 100644 index 0000000..baddaa9 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/error-notifications-provided.11tydata.js @@ -0,0 +1,3 @@ +module.exports = { + ...require('../../build/get-outcome')(__dirname) +} diff --git a/how-to/outcomes/error-notifications-provided/examples.md b/how-to/outcomes/error-notifications-provided/examples.md new file mode 100644 index 0000000..8b2264a --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/examples.md @@ -0,0 +1,5 @@ +--- +title: Examples +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/index.md b/how-to/outcomes/error-notifications-provided/index.md new file mode 100644 index 0000000..eeb7edc --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/index.md @@ -0,0 +1,23 @@ +--- +title: Get Started +--- + +
+

{{ outcome.description }}

+
+ +## Summary + +Coming soon + +## Why + +Coming soon + +## Who it helps + +Coming soon + +## How + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods.md b/how-to/outcomes/error-notifications-provided/methods.md new file mode 100644 index 0000000..d2d86cc --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods.md @@ -0,0 +1,5 @@ +--- +layout: layout/methods.md +--- + + diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/background.md b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/background.md new file mode 100644 index 0000000..35176bb --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/background.md @@ -0,0 +1,17 @@ +--- +subtitle: Background +--- + +Coming soon + +### Bibliography + +- [Coming soon](https://) + +### Assumptions + +- [Coming soon](https://) + +### Accessibility Support + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/code-snippets.md b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/code-snippets.md new file mode 100644 index 0000000..eb56b89 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/code-snippets.md @@ -0,0 +1,33 @@ +--- +subtitle: Code Snippets +--- + +### Passed + +#### Passed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Failed + +#### Failed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Inapplicable + +#### Inapplicable Example 1 + +Coming soon + +```html +Code snippet +``` diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/definitions.md b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/definitions.md new file mode 100644 index 0000000..93ee43b --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/definitions.md @@ -0,0 +1,5 @@ +--- +subtitle: Technical Definitions +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/discernable-consistent-accessible.json b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/discernable-consistent-accessible.json new file mode 100644 index 0000000..53f03bf --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/discernable-consistent-accessible.json @@ -0,0 +1,8 @@ +{ + "method": { + "index": 1, + "title": "Error messages need to be discernible, consistent, and accessible", + "slug": "discernable-consistent-accessible", + "description": "" + } +} diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/index.md b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/index.md new file mode 100644 index 0000000..6af53a2 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/index.md @@ -0,0 +1,22 @@ +--- +subtitle: Introduction +--- + +### Summary + +Coming soon + +
+
+
Platform:
+
Any platform supporting HTML
+
+
+
Technology:
+
HTML
+
+
+ +### How it solves user need + +Coming soon \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/test.md b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/test.md new file mode 100644 index 0000000..6d8c886 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/discernable-consistent-accessible/test.md @@ -0,0 +1,19 @@ +--- +subtitle: Test +--- + +Can the user discern or detect the error notification? + +* Should not be off-screen or be a sound-only. + +* Is the notification semantic and meets other sections of WCAG3? + +* The notification should be consistent relative to the view, process or trigger so it is easier for a user to identify the source of the error and locate what location, window, or tab is producing the error. + +### Applicability + +Coming soon + +### Expectation + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/methods.json b/how-to/outcomes/error-notifications-provided/methods/methods.json new file mode 100644 index 0000000..f25a945 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/methods.json @@ -0,0 +1,3 @@ +{ + "type": "method" +} \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/background.md b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/background.md new file mode 100644 index 0000000..35176bb --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/background.md @@ -0,0 +1,17 @@ +--- +subtitle: Background +--- + +Coming soon + +### Bibliography + +- [Coming soon](https://) + +### Assumptions + +- [Coming soon](https://) + +### Accessibility Support + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/code-snippets.md b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/code-snippets.md new file mode 100644 index 0000000..eb56b89 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/code-snippets.md @@ -0,0 +1,33 @@ +--- +subtitle: Code Snippets +--- + +### Passed + +#### Passed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Failed + +#### Failed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Inapplicable + +#### Inapplicable Example 1 + +Coming soon + +```html +Code snippet +``` diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/definitions.md b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/definitions.md new file mode 100644 index 0000000..93ee43b --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/definitions.md @@ -0,0 +1,5 @@ +--- +subtitle: Technical Definitions +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/index.md b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/index.md new file mode 100644 index 0000000..ba9c7cb --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/index.md @@ -0,0 +1,34 @@ +--- +subtitle: Introduction +--- + +* User Agents: + * When the page load fails, the browser handles server created errors through the headers. The server can provide a page to react or the browser react. The browser-provided-page needs to be understandable. + * Browsers support `` element so authors can style it appropriately. + * Browsers can re-direct URL typos (or attacks) to common correct URLs (and inform the user when they do so.) + +* Assistive Technologies: + * Assistive Technologies need to inform users that an error notification such as a modal window is opening. + * Assistive Technologies need to support the `` element +* APIs. The spec is supported and implemented correctly. The API has to fire an event to notify the assistive technology that the event has occurred. We need to enforce that all parts of the stack cooperate. + +* Note: These should not be separate methods but should be part of ARIA or Core Accessibility API, OR we have a built out example of how all the different parts fit together coherently to realize these outcomes + +### Summary + +Coming soon + +
+
+
Platform:
+
Any platform supporting HTML
+
+
+
Technology:
+
HTML
+
+
+ +### How it solves user need + +Coming soon \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/tech-stack-notifications.json b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/tech-stack-notifications.json new file mode 100644 index 0000000..76ca5c0 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/tech-stack-notifications.json @@ -0,0 +1,8 @@ +{ + "method": { + "index": 1, + "title": "The technology stack supports notifications", + "slug": "tech-stack-notifications", + "description": "" + } +} diff --git a/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/test.md b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/test.md new file mode 100644 index 0000000..08fd19a --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/tech-stack-notifications/test.md @@ -0,0 +1,13 @@ +--- +subtitle: Test +--- + +Coming soon + +### Applicability + +Coming soon + +### Expectation + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/background.md b/how-to/outcomes/error-notifications-provided/methods/what-errors/background.md new file mode 100644 index 0000000..35176bb --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/background.md @@ -0,0 +1,17 @@ +--- +subtitle: Background +--- + +Coming soon + +### Bibliography + +- [Coming soon](https://) + +### Assumptions + +- [Coming soon](https://) + +### Accessibility Support + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/code-snippets.md b/how-to/outcomes/error-notifications-provided/methods/what-errors/code-snippets.md new file mode 100644 index 0000000..eb56b89 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/code-snippets.md @@ -0,0 +1,33 @@ +--- +subtitle: Code Snippets +--- + +### Passed + +#### Passed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Failed + +#### Failed Example 1 + +Coming soon + +```html +Code snippet +``` + +### Inapplicable + +#### Inapplicable Example 1 + +Coming soon + +```html +Code snippet +``` diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/definitions.md b/how-to/outcomes/error-notifications-provided/methods/what-errors/definitions.md new file mode 100644 index 0000000..93ee43b --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/definitions.md @@ -0,0 +1,5 @@ +--- +subtitle: Technical Definitions +--- + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/index.md b/how-to/outcomes/error-notifications-provided/methods/what-errors/index.md new file mode 100644 index 0000000..70e8211 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/index.md @@ -0,0 +1,29 @@ +--- +subtitle: Introduction +--- + +* Some errors do not require user intervention and correction of error. Users should not be interrupted for repetitive levels that don't require user action, such as a quick network connection drop. See the examples from [What to do with repetitive errors of low severity?](https://docs.google.com/document/d/1jtZaUzLi-jgmGdAypRUeJPzVz_ZUpMO0wdOrORiuO7w/edit#heading=h.8sxd4rwnfmg2) + +* If the system cannot move forward without user intervention, they should be notified. + +* If the system fails even if the user can’t fix it. If the app can’t do something, the user needs to be notified that something has gone wrong. If they can fix it, the user should be told how, and if they can’t, they should be told whatever is appropriate, even “try again in 30 minutes” + + +### Summary + +Coming soon + +
+
+
Platform:
+
Any platform supporting HTML
+
+
+
Technology:
+
HTML
+
+
+ +### How it solves user need + +Coming soon \ No newline at end of file diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/test.md b/how-to/outcomes/error-notifications-provided/methods/what-errors/test.md new file mode 100644 index 0000000..baa8bf5 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/test.md @@ -0,0 +1,15 @@ +--- +subtitle: Test +--- + +1. Identify when an error is made to make the judgement call of whether an error notification should exist (system errors as well as user errors) (see the [list of user flows](https://docs.google.com/document/d/1siHMdNk96v2DVY6sarjZCDt5-nvqvQq13bXOOYymNlw/edit#)) + +2. If an error is made, does an error notification exist? + +### Applicability + +Coming soon + +### Expectation + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/methods/what-errors/what-errors.json b/how-to/outcomes/error-notifications-provided/methods/what-errors/what-errors.json new file mode 100644 index 0000000..884a180 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/methods/what-errors/what-errors.json @@ -0,0 +1,8 @@ +{ + "method": { + "index": 1, + "title": "What errors should be notified?", + "slug": "what-errors", + "description": "" + } +} diff --git a/how-to/outcomes/error-notifications-provided/outcome.json b/how-to/outcomes/error-notifications-provided/outcome.json new file mode 100644 index 0000000..19ef581 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/outcome.json @@ -0,0 +1,5 @@ +{ + "index": 0, + "title": "Notifications provided", + "description": "Provides notification of an error so users know that an error has occurred." +} diff --git a/how-to/outcomes/error-notifications-provided/resources.md b/how-to/outcomes/error-notifications-provided/resources.md new file mode 100644 index 0000000..368fbda --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/resources.md @@ -0,0 +1,7 @@ +--- +title: Resources +--- + +## W3C Resources + +Coming soon diff --git a/how-to/outcomes/error-notifications-provided/user-needs.md b/how-to/outcomes/error-notifications-provided/user-needs.md new file mode 100644 index 0000000..4712ea3 --- /dev/null +++ b/how-to/outcomes/error-notifications-provided/user-needs.md @@ -0,0 +1,71 @@ +--- +title: User Needs +--- + +
+

{{ outcome.description }}

+
+ +## Barriers Encountered + +* No error message +* Error message that is not accessible to assistive technology (e.g., screen reader or reading assistance software) +* Error message that is not visible (e.g., not in viewport) +* Error message that is not identifiable (e.g., not recognizable as an error message) +* Error message that is not legible (e.g., not distinguishable) + +## Common User Needs + +* Error message: User needs an error message when an error occurs so they know something went wrong. +* Notification of changed values: User needs form to notify them when it changes values so they can review and verify accuracy of any changes to data. + +## Unique User Needs + +* Visual notification: User needs a visual notification so they know something went wrong. +* Error message displays in viewport: User needs an error message that displays in the viewport so they can identify the error message and access the content with screen magnification. +* High-contrast error message: User needs a prominent high-contrast error message so they can identify the error message. +* Error message visually identifiable without symbols: User needs an error message that is identifiable without symbols so they can identify the error message. +* Error message visually identifiable without text: User needs an error message that is identifiable without text so they can identify the error message. +* Error message in consistent interface: User needs an error message with a consistent interface so they know they are interacting with the same digital product. + +## Barriers Encountered + +* Error source is not visually identified +* Error source is not programmatically identified +* Error source is not programmatically associated with error message +* Error source is not accessible to assistive technology +* Error source indicator is not identifiable (e.g., not recognizable as an error source indicator) +* Error source indicator is not legible (e.g., not distinguishable) +* Error notification does not occur at time of error +* Time-limited error notification limits access to instructions +* Error source visual label is not the same as its programmatic label, making it difficult to move focus using speech +* Error message doesn’t match source: Error message provides a different, ambiguous, or incomplete field label than the searchable visual label, making it difficult to search for the term in the form. + +## Common User Needs + +* Visual error source indicator: User needs a visual indicator of the error source so they know which component is the source of the error. +* Error message provided when error occurs: User needs an error message that is provided when the error occurs so they can readily refocus on the source of the error. +* Error message persists: User needs an error message that persists until the error is remedied so they can access the remedy instructions for as long as it takes to address the error. +* Error message linked to error source: User needs an error message that is linked to the error source so they can readily move focus to invalid inputs to correct them. +* Error message focused on reload: User needs an error message that is focused when the page reloads so they know there was an error + +## Unique User Needs + +* High-contrast error source indicator: User needs a prominent high-contrast error source indicator so they can identify the error source. + +## Functional Needs + +* Essential +* Sensory - Vision and Visual +* Sensory - Sensory Intersections +* Cognitive - Attention +* Cognitive - Language and Literacy +* Cognitive - Learning +* Cognitive - Memory +* Cognitive - Executive +* Cognitive - Mental Health +* Cognitive - Cognitive and Sensory Intersections +* Independence +* Physical - Mobility +* Physical - Motor +* Physical & Sensory Intersections diff --git a/how-to/outcomes/error-remedy-instructions/activities/activities.json b/how-to/outcomes/error-remedy-instructions/activities/activities.json new file mode 100644 index 0000000..aeadf6c --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/activities.json @@ -0,0 +1,4 @@ +{ + "type": "activity", + "title": "Activity" +} \ No newline at end of file diff --git a/how-to/outcomes/error-remedy-instructions/activities/design.md b/how-to/outcomes/error-remedy-instructions/activities/design.md new file mode 100644 index 0000000..b0e47c2 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/design.md @@ -0,0 +1,5 @@ +--- +subtitle: Design +--- + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/activities/develop.md b/how-to/outcomes/error-remedy-instructions/activities/develop.md new file mode 100644 index 0000000..e8a7da6 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/develop.md @@ -0,0 +1,5 @@ +--- +subtitle: Develop +--- + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/activities/edit.md b/how-to/outcomes/error-remedy-instructions/activities/edit.md new file mode 100644 index 0000000..41c567a --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/edit.md @@ -0,0 +1,5 @@ +--- +subtitle: Edit +--- + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/activities/plan.md b/how-to/outcomes/error-remedy-instructions/activities/plan.md new file mode 100644 index 0000000..aa2a004 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/plan.md @@ -0,0 +1,5 @@ +--- +subtitle: Plan +--- + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/activities/test.md b/how-to/outcomes/error-remedy-instructions/activities/test.md new file mode 100644 index 0000000..bae716a --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/activities/test.md @@ -0,0 +1,5 @@ +--- +layout: layout/test-activity.md +--- + + diff --git a/how-to/outcomes/error-remedy-instructions/error-remedy-instructions.11tydata.js b/how-to/outcomes/error-remedy-instructions/error-remedy-instructions.11tydata.js new file mode 100644 index 0000000..baddaa9 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/error-remedy-instructions.11tydata.js @@ -0,0 +1,3 @@ +module.exports = { + ...require('../../build/get-outcome')(__dirname) +} diff --git a/how-to/outcomes/error-remedy-instructions/examples.md b/how-to/outcomes/error-remedy-instructions/examples.md new file mode 100644 index 0000000..8b2264a --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/examples.md @@ -0,0 +1,5 @@ +--- +title: Examples +--- + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/index.md b/how-to/outcomes/error-remedy-instructions/index.md new file mode 100644 index 0000000..eeb7edc --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/index.md @@ -0,0 +1,23 @@ +--- +title: Get Started +--- + +
+

{{ outcome.description }}

+
+ +## Summary + +Coming soon + +## Why + +Coming soon + +## Who it helps + +Coming soon + +## How + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/methods.md b/how-to/outcomes/error-remedy-instructions/methods.md new file mode 100644 index 0000000..d2d86cc --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/methods.md @@ -0,0 +1,5 @@ +--- +layout: layout/methods.md +--- + + diff --git a/how-to/outcomes/error-remedy-instructions/methods/methods.json b/how-to/outcomes/error-remedy-instructions/methods/methods.json new file mode 100644 index 0000000..f25a945 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/methods/methods.json @@ -0,0 +1,3 @@ +{ + "type": "method" +} \ No newline at end of file diff --git a/how-to/outcomes/error-remedy-instructions/outcome.json b/how-to/outcomes/error-remedy-instructions/outcome.json new file mode 100644 index 0000000..bb8ac99 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/outcome.json @@ -0,0 +1,5 @@ +{ + "index": 0, + "title": "Instructions provided to remedy errors", + "description": "Provides instructions in response to an error so users know what steps to take to remedy the error." +} diff --git a/how-to/outcomes/error-remedy-instructions/resources.md b/how-to/outcomes/error-remedy-instructions/resources.md new file mode 100644 index 0000000..368fbda --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/resources.md @@ -0,0 +1,7 @@ +--- +title: Resources +--- + +## W3C Resources + +Coming soon diff --git a/how-to/outcomes/error-remedy-instructions/user-needs.md b/how-to/outcomes/error-remedy-instructions/user-needs.md new file mode 100644 index 0000000..e3af8b9 --- /dev/null +++ b/how-to/outcomes/error-remedy-instructions/user-needs.md @@ -0,0 +1,40 @@ +--- +title: User Needs +--- + +
+

{{ outcome.description }}

+
+ +## Barriers Encountered + +* No remedy instructions +* Unhelpful remedy instructions +* Remedy instructions that are not understandable (e.g., not clear) + +## Common User Needs + +* Error message includes remedy instructions: User needs an error message describing the remedy so they know how to recover from the error. +* Error message with remedy instructions displays at source of error: User needs an error message that displays at the source of the error so they can access the remedy instructions while focused on the source of the error. + +## Unique User Needs + +* Programmatically associated error message and source of error: User needs an error message that is programmatically associated with the source of the error so they can access the remedy instructions while focused on the source of the error. +* Reassuring remedy instructions: User needs reassuring remedy instructions so they can have confidence they can resolve the error. + +## Functional Needs + +* Essential +* Sensory - Vision and Visual +* Sensory - Sensory Intersections +* Cognitive - Attention +* Cognitive - Language and Literacy +* Cognitive - Learning +* Cognitive - Memory +* Cognitive - Executive +* Cognitive - Mental Health +* Cognitive - Cognitive and Sensory Intersections +* Independence +* Physical - Mobility +* Physical - Motor +* Physical & Sensory Intersections diff --git a/how-to/outcomes/timely-targeted-guidance/activities/activities.json b/how-to/outcomes/timely-targeted-guidance/activities/activities.json new file mode 100644 index 0000000..aeadf6c --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/activities.json @@ -0,0 +1,4 @@ +{ + "type": "activity", + "title": "Activity" +} \ No newline at end of file diff --git a/how-to/outcomes/timely-targeted-guidance/activities/design.md b/how-to/outcomes/timely-targeted-guidance/activities/design.md new file mode 100644 index 0000000..b0e47c2 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/design.md @@ -0,0 +1,5 @@ +--- +subtitle: Design +--- + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/activities/develop.md b/how-to/outcomes/timely-targeted-guidance/activities/develop.md new file mode 100644 index 0000000..e8a7da6 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/develop.md @@ -0,0 +1,5 @@ +--- +subtitle: Develop +--- + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/activities/edit.md b/how-to/outcomes/timely-targeted-guidance/activities/edit.md new file mode 100644 index 0000000..41c567a --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/edit.md @@ -0,0 +1,5 @@ +--- +subtitle: Edit +--- + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/activities/plan.md b/how-to/outcomes/timely-targeted-guidance/activities/plan.md new file mode 100644 index 0000000..aa2a004 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/plan.md @@ -0,0 +1,5 @@ +--- +subtitle: Plan +--- + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/activities/test.md b/how-to/outcomes/timely-targeted-guidance/activities/test.md new file mode 100644 index 0000000..bae716a --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/activities/test.md @@ -0,0 +1,5 @@ +--- +layout: layout/test-activity.md +--- + + diff --git a/how-to/outcomes/timely-targeted-guidance/examples.md b/how-to/outcomes/timely-targeted-guidance/examples.md new file mode 100644 index 0000000..8b2264a --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/examples.md @@ -0,0 +1,5 @@ +--- +title: Examples +--- + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/index.md b/how-to/outcomes/timely-targeted-guidance/index.md new file mode 100644 index 0000000..eeb7edc --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/index.md @@ -0,0 +1,23 @@ +--- +title: Get Started +--- + +
+

{{ outcome.description }}

+
+ +## Summary + +Coming soon + +## Why + +Coming soon + +## Who it helps + +Coming soon + +## How + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/methods.md b/how-to/outcomes/timely-targeted-guidance/methods.md new file mode 100644 index 0000000..d2d86cc --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/methods.md @@ -0,0 +1,5 @@ +--- +layout: layout/methods.md +--- + + diff --git a/how-to/outcomes/timely-targeted-guidance/methods/methods.json b/how-to/outcomes/timely-targeted-guidance/methods/methods.json new file mode 100644 index 0000000..f25a945 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/methods/methods.json @@ -0,0 +1,3 @@ +{ + "type": "method" +} \ No newline at end of file diff --git a/how-to/outcomes/timely-targeted-guidance/outcome.json b/how-to/outcomes/timely-targeted-guidance/outcome.json new file mode 100644 index 0000000..1657c4f --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/outcome.json @@ -0,0 +1,5 @@ +{ + "index": 0, + "title": "Timely and targeted guidance", + "description": "Provides notification when the error occurs and identifies the source of error so users can readily refocus and remedy the error." +} diff --git a/how-to/outcomes/timely-targeted-guidance/resources.md b/how-to/outcomes/timely-targeted-guidance/resources.md new file mode 100644 index 0000000..368fbda --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/resources.md @@ -0,0 +1,7 @@ +--- +title: Resources +--- + +## W3C Resources + +Coming soon diff --git a/how-to/outcomes/timely-targeted-guidance/timely-targeted-guidance.11tydata.js b/how-to/outcomes/timely-targeted-guidance/timely-targeted-guidance.11tydata.js new file mode 100644 index 0000000..baddaa9 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/timely-targeted-guidance.11tydata.js @@ -0,0 +1,3 @@ +module.exports = { + ...require('../../build/get-outcome')(__dirname) +} diff --git a/how-to/outcomes/timely-targeted-guidance/user-needs.md b/how-to/outcomes/timely-targeted-guidance/user-needs.md new file mode 100644 index 0000000..7351374 --- /dev/null +++ b/how-to/outcomes/timely-targeted-guidance/user-needs.md @@ -0,0 +1,49 @@ +--- +title: User Needs +--- + +
+

{{ outcome.description }}

+
+ +## Barriers Encountered + +* Error source is not visually identified +* Error source is not programmatically identified +* Error source is not programmatically associated with error message +* Error source is not accessible to assistive technology +* Error source indicator is not identifiable (e.g., not recognizable as an error source indicator) +* Error source indicator is not legible (e.g., not distinguishable) +* Error notification does not occur at time of error +* Time-limited error notification limits access to instructions +* Error source visual label is not the same as its programmatic label, making it difficult to move focus using speech +* Error message doesn’t match source: Error message provides a different, ambiguous, or incomplete field label than the searchable visual label, making it difficult to search for the term in the form. + +## Common User Needs + +* Visual error source indicator: User needs a visual indicator of the error source so they know which component is the source of the error. +* Error message provided when error occurs: User needs an error message that is provided when the error occurs so they can readily refocus on the source of the error. +* Error message persists: User needs an error message that persists until the error is remedied so they can access the remedy instructions for as long as it takes to address the error. +* Error message linked to error source: User needs an error message that is linked to the error source so they can readily move focus to invalid inputs to correct them. +* Error message focused on reload: User needs an error message that is focused when the page reloads so they know there was an error + +## Unique User Needs + +* High-contrast error source indicator: User needs a prominent high-contrast error source indicator so they can identify the error source. + +## Functional Needs + +* Essential +* Sensory - Vision and Visual +* Sensory - Sensory Intersections +* Cognitive - Attention +* Cognitive - Language and Literacy +* Cognitive - Learning +* Cognitive - Memory +* Cognitive - Executive +* Cognitive - Mental Health +* Cognitive - Cognitive and Sensory Intersections +* Independence +* Physical - Mobility +* Physical - Motor +* Physical & Sensory Intersections