department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
281 stars 201 forks source link

Error message style guide and dictionary iteration #34490

Open DanielleThierryUSDSVA opened 2 years ago

DanielleThierryUSDSVA commented 2 years ago

High Level User Stories

As a Veteran or family member, I need clear and actionable error messages so I can quickly resolve problems related to VA.gov.

As a contact center representative, I need VA.gov error messages and related support articles that encourage self-service and lower contact center volume so I can focus my time on problems that require my expertise.

As a VA designer, UX content writer, or developer, I need an easy way to find the right error message for my use case and up-to-date guidance for when I need to create a new error message.

As a VA content team member, I need an established process for adding new error messages to the error message dictionary.

Hypothesis or Bet

If we create a more robust, optimized error message guide and dictionary with a process for continuing with updates then we can help Veterans resolve problems faster, lower contact center calls, and make it easier for product teams to create error messages.

OKR

Which Objective / Key Result does this epic push forward?

Definition of done

What must be true in order for you to consider this epic complete?

Take into consideration Accessibility/QA needs as well as Product, Technical, and Design requirements.

How to configure this issue

sara-amanda commented 1 year ago

@kristinoletmuskat adding to GHP and Epics lane

megzehn commented 2 weeks ago

Note that we are tracking some error message work in this ticket: 48825