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 202 forks source link

[a11y Design Review] Apply for a medallion #94735

Open sara-amanda opened 2 days ago

sara-amanda commented 2 days ago

[!NOTE] QUICK SUMMARY:

  • Review: Figma file
  • CAIA Review Date:
  • Review Purpose: Preparing for Midpoint
  • Reviewed By: @coforma-jamie

Next Steps

[!TIP] DEFINITION OF DONE: Refer to the task list in this ticket, for actionable items.

Description

CAIA A11ys can review the Figma prototype files for desktop and mobile (if available), in order to provide feedback that may help your team successfully improve the accessibility of VA Form 40-1330M, Apply for a medallion in a private cemetery.

Details

CAIA Intake Ticket 85541

Toggle to view intake information about the initiative and desired outcomes ##### Initial Request > We hope to have accessibility and content specialist analyze the work we've conducted so far regarding VA Form 40-1330M, Apply for a medallion in a private cemetery form. In this form, we create a new digital form applying for a medallion to fix to a private headstone or marker. > > We hope to have the content team analyze the content decisions we've made so far, and provide recommendations for further improvements. This includes the entire medallions form, and the two potential solutions we have so far for multiple signatures. You can add comments in the Figma file as needed. > > We hope to have accessibility team members assess the entire medallions form, and provide accessibility recommendations for further improvements. We ask the accessibility team to look over this DocuSign link to test for accessibility for ongoing feedback, [DocuSign link](https://demo.services.docusign.net/webforms-ux/v1.0/forms/4e3fda343cdaa54263be7213ae0026ee). If the accessibility team could prioritize this DocuSign effort, it would be much appreciated.

CAIA CC Ticket 93101

Toggle to view initial accessibility feedback from Design Intent for quick reference ##### Accessibility Feedback > **Must**: When using the [minimal header](https://design.va.gov/components/header/header-minimal), avoid duplication between the text in the header and the H1 on each page of the form flow. The minimal header was originally intended to streamline a form flow by putting the name of the form in the header banner and then use unique H1s to describe the purpose of each page in the flow. You don't necessarily have to follow that model, but you don't get a lot of benefit from having a duplicative H1. > > **Should**: In the Review and Sign workflow, the name of the form should reflect what it is, not what the user is doing. When you land on the Review and Sign form, you don't have a lot of immediate context for what the purpose of the form is. > > **Should**: When starting the Review and Sign workflow, the content as written now references the VA form number but never explains what that form is. Try to maintain plain language here. > > **Consider**: When a user starts the Review and Sign workflow, they may not already have a VA.gov account. I think it would be worthwhile to specifically call that out --- eg. "If you don't already have an account, you'll need to create one" --- and give a rough estimate for how long it will take to create an account. Users in general, but especially users with disabilities, sometimes need to be mindful of how long a process might take and what kind of commitment they're making when they start a process. Giving some heads up about what's involved would be helpful. > > **Should**: There are a few pages in the workflow where I think it would be appropriate to move some of it onto another page --- eg. [recipient delivery address and contact details](https://www.figma.com/design/QIMsAdHJjctTKDM1I34uXV/Medallions---Baseline-Prototype?node-id=1742-49978&t=aRp8Q6bh9PzXhSkr-4) could be two pages, one for delivery address and one for contact details. I think a safe rule here is, if you've got two headings on a page to section out the content, you can probably break it into two pages. See the [one thing per page guidance](https://design.va.gov/patterns/ask-users-for/a-single-response) in the design system for a longer discussion. >

About the Team

Toggle to view team info - **Team name**: Memorials Self-Service - **OCTO product owner**: Matt Self - **Product name**: Apply for a medallion in a private cemetery - **Product manager**: Catherine Hughes - **Slack channel**: [#sitewide-content-accessibility-ia](https://join.slack.com/share/enQtNzI1MjcxNzM4MDIxMi0zOWVhNjIyMWVhNDZlMzkzNmMzY2E2MzM1ZDMzYjViYmQ3YzU4OTE3ZTZhMjkzNDI4OTc2MzM3NTJhMWE0NWY2) - Dedicated content writer on your team (if you have one): N/A, UX Team - Dedicated a11y specialist on your team (if you have one): N/A, UX Team

CAIA Assignee(s)

Toggle to view assignee info @coforma-jamie

Supporting Artifacts

### a11y Tasks
- [x] **CAIA Intake Opened** `6/10/2024`
- [x] Receive Figma Prototype `10/9/2024`
- [x] Create a [Figma Prototype Review Google Doc from Template](https://docs.google.com/document/d/1iWT1OiGsE6GpevBIGDpTHTJCC8FJt5qPYze38scEeSo/edit#heading=h.k9qpiv683iya) `Make copy`
- [ ] **Review of the File** @coforma-jamie
- [ ] **Additional Support** [Review the menu of services with the team](https://github.com/department-of-veterans-affairs/va.gov-team/tree/master/teams/CAIA/accessibility#services-we-offer).
- [ ] **Inquire:** Will there be future research with assistive technology?
### Acceptance Criteria
- [ ] **Complete** Review of the Figma File
- [ ] **Share** the [Figma Prototype Review Google Doc](https://docs.google.com/document/d/1-OrfxmBO06rJtrd-R_K82-FDigOy2qAqqnR3bnu_yA4/edit?tab=t.0) with the team.
- [ ] **Provide feedback prior to Midpoint** (date not present in CC ticket as of 10/9/2024)
## Ticket Updates (CAIA Internal)
- [ ] _Connect to an `Epic` or `Intake` (what body of work is this a part of?)_
- [x] _Label with `Originator/Team` (product team or stakeholder requesting support)_
- [x] _Label date in the `Open Date` field_
- [x] _Label with `Estimate` (level of effort expected for this ticket)_
- [x] _Add `Assignee(s)` name(s) to ticket_ (include Naomi)
- [x] _Add `Assignee(s) name(s) to each task` they will complete via handle tag (if known)_
- [x] _Select a `Priority Level`_
- [x] _Update date in `Last Checked` field_
- [ ] _Label with `Actual` (level of effort it took to complete this ticket)_
- [ ] _Update date in_ `Closed Date`
### Related Tickets
- [ ] #85541
- [ ] https://github.com/department-of-veterans-affairs/vets-design-system-documentation/issues/3253
- [ ] #91309
- [ ] #93101
sara-amanda commented 2 days ago

OCTO Feedback

@artsymartha68 this is a new ticket for the anticipated design review work. Wanting to confirm with you that the priority level should match that of the intake ticket #85541 , which is Medium - please advise if we should adjust. Many thanks!

cc; @coforma-jamie

Note, I plan to remove assignee @artsymartha68 once prioritization is verified. This is since we are in-between meetings and will be working on it this week - for visibility. 😄

coforma-jamie commented 1 day ago

@barron-charles @carly-yamrus - here's the feedback I can provide so far. Ping me here once you've added annotations, and I'll review those and share more feedback! :)

Issue: Button pair should be left-aligned

Issue: Spell out acronym in link text

Think about: Prefill message placement

Issue: Fuzzy images on retina displays

barron-charles commented 1 day ago

@coforma-jamie Thank you very much. We'll take a deeper look at these, and make further revisions from your recommendations!