search

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
283 stars 204 forks source link

508-defect-2 [COGNITION, SEMANTIC MARKUP]: Alert for cerner user should be designed and written semantically #25049

Closed joshkimux closed 3 years ago

joshkimux commented 3 years ago

508-defect-2

Feedback framework

Definition of done

  1. Review and acknowledge feedback.
  2. Fix and/or document decisions made.
  3. Accessibility specialist will close ticket after reviewing documented decisions / validating fix.

Point of Contact

VFS Point of Contact: Josh

User Story or Problem Statement

As a screen reader user, I want to navigate through logical headings that aren't skipped. As a voice assistive tech user, I want links to be designed as links so I can activate them correctly. As a keyboard user, I want links to be styled as links so that I know to use enter and not space. As a user with cognitive disabilities, I want content to be designed simply in a way I can parse.

Details

The alert for the cerner user has several issues to be addressed:

Acceptance Criteria

Steps to Recreate

Possible Solution

Consider the following design:

Screen Shot 2021-05-20 at 4 41 15 PM

Alternatively, if this content will be difficult for folks to understand, consider redesigning the UX around that. For example, providing a small form flow to help them decide which to pick may be helpful.

I'd recommend shortening the headings. Guidance from the content team @peggygannon would be valuable.

Screenshots or Trace Logs

Screen Shot 2021-05-20 at 4 32 30 PM Screen Shot 2021-05-20 at 1 53 40 PM
tressaellen commented 3 years ago

Hi @joshkimux - would you mind elaborating more on the 'design is simplified' acceptance criteria bullet? I'm happy to hop on a call if that's easier. Thank you!

joshkimux commented 3 years ago

@tressaellen Yes, more than happy to hop on a call! By "simplify" the design, I should have been more specific 🙇 I meant to ask if it was possible to reduce the length and complexity of the content. Here's an example of how that could be approached, but definitely is not the solution. It might be worth looping in Danielle to help?

image

tressaellen commented 3 years ago

@joshkimux thanks for the clarification! That makes sense. @ajakabcin do you mind making a content ticket for this? And looping in Danielle, beth and me?

DanielleThierryUSDSVA commented 3 years ago

Hi @ajakabcin @tressaellen @joshkimux! Had a few minutes to take a quick initial look at this, and I'm wondering if we can simplify this even more. Some initial versions below...would want to think about this more and check back on notes to make sure we're not missing something here in simplifying. Happy to also jump on a call to brainstorm together if that's helpful.

# V1

Your care team may now use our new My VA Health portal

Choose your portal based on the facility for your appointment.

You may need to disable your browser’s pop-up blocker to open the portal. If you’re prompted to sign in again, use the same account you used to sign in to VA.gov.

For Charles P. Wylie Veterans Outpatient Clinic

[link] Use My VA Health

For any other VA health facility

[link] Use My HealtheVet

# V2

Your care team may now use our new My VA Health portal

Choose your portal based on the facility for your appointment:

Note: You may need to disable your browser’s pop-up blocker to open the portal. If you’re prompted to sign in again, use the same account you used to sign in to VA.gov.

# V3

Choose your health management portal

Your care team may now use our new My VA Health portal. Choose your portal based on the facility for your appointment.

You may need to disable your browser’s pop-up blocker to open the portal. If you’re prompted to sign in again, use the same account you used to sign in to VA.gov.

For Charles P. Wylie Veterans Outpatient Clinic

[link] Use My VA Health

For any other VA health facility

[link] Use My HealtheVet

# V4

Choose your health management portal

Your care team may now use our new My VA Health portal. Choose your portal based on the facility for your appointment:

If you have trouble accessing the portal: Make sure to disable your pop-up blocker. If you’re prompted to sign in again, use the same account you used to sign in to VA.gov.

joshkimux commented 3 years ago

This is awesome Danielle! Thank you!

I like version 4 for the clear language "if you have trouble accessing the portal." I also think headings may be a bit too much for presenting options to the user that each only have one link and no other content.

Something short and sweet may be easiest for folks to parse through.

ajakabcin commented 3 years ago

If version 4 (noted above) works for you @tressaellen and @erikphansen then it's good for me as well!

ajakabcin commented 3 years ago

Thank you @joshkimux and @DanielleThierryUSDSVA for the feedback here! We'll go with version 4 and address in a separate ticket. I'll update the AC to reflect this.

ajakabcin commented 3 years ago

Given the changes in the content and design of the alert the initial two AC about headers jumping and appropriately styled links is no longer applicable. I'll close this as we already have another FE ticket to implement the revised content and design: #28575