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

[CAIA Intake] Benefits - Dependent Experience Team: Review of 686c/674 Form Updates #75068

Open steele-lm opened 8 months ago

steele-lm commented 8 months ago

Content, accessibility, information architecture (CAIA) new initiative collaboration request

Use this ticket to start collaboration on a new initiative with the sitewide content, accessibility, and information architecture (CAIA) team.

Note: If you’re already partnering with us on an initiative, you don't need to fill out this request form. If you don’t have access to your initiative’s CAIA epic, post a message in the #sitewide-content-accessibility-ia slack channel and tag @Terry Nichols and @Lily Strelich.

About your team

About your initiative

Which of these descriptions best fits the work we’ll partner on?

Select all that apply.

What's the nature of your initiative and desired outcomes?

Veterans are submitting online 686/674 claims that generate outdated pdf claim forms, are missing information, and/or contain information that is no longer required. Downstream systems (RBPS) need to offramp these claims for manual processing, which delays the Veteran's benefits. Our desired outcome: Veterans submitting online 21-686c and 21-674 claims can trust that their submissions include all the required information to ensure efficient processing.

Collaboration timeframe

Note: We work on nearly every OCTO product and manage all unauthenticated content on VA.gov, so we will need to prioritize intake requests based on overall workload and VA and OCTO priorities.

Is this work tied to a Congressional mandate, change in law or policy, or upcoming event with a specific deadline?

Where are you at in your timeline?

We have initial designs drafted, and we completed the Design Intent on 1/30/2024. We are currently working to incorporate feedback from Design Intent.

Collaboration cycle

Which phases of the collaboration cycle have you completed?

Select all that apply.

Collaboration cycle ticket

If you’re going through the collaboration cycle, provide your ticket number and link:

Supporting artifacts

Provide links to any supporting artifacts that can help us better understand your initiative and begin collaboration. Include artifacts like your product outline, user flows, mockups and prototypes, or any draft content.

Next steps

Tasks


### VFS team tasks
- [ ] **If you also need engineering support from the public websites team**, fill out their intake request form as well.<br> [Open a public websites intake request](https://github.com/department-of-veterans-affairs/va.gov-team/issues/new?assignees=Public+Websites%2C+Sitewide+content&labels=vsa-public-websites%2C+vsa%2C+vsa-public-websites-intake%2C+sitewide-content%2C+needs-grooming&template=public-websites-intake.md&title=%3CType+of+Request%3E+from+%3CTeam%3E)
- [ ] **If you're requesting a page/URL redirect, a URL change, or a vanity URL**, submit an additional request for this work. <br> [Open a redirect, URL change, or vanity URL request](https://github.com/department-of-veterans-affairs/va.gov-team/issues/new?assignees=jennymayoco%2C+kristinoletmuskat%2C+strelichl%2C+FranECross&labels=sitewide+CAIA%2C+Sitewide+IA%2C+Public+Websites%2C+VA.gov+frontend%2C+Redirect+request&projects=&template=redirect-request.md&title=Redirect+Request)
- [ ] **If you're creating an experimental design**, also contact the design system team. <br> [Read more about experimental designs](https://design.va.gov/about/contributing-to-the-design-system/experimental-components-and-patterns#what-is-an-experimental-component-or-pattern?) <br> [Suggest an addition or update to the design system team](https://design.va.gov/about/contributing-to-the-design-system/suggest-an-addition-or-update)
- [ ] **If you're requesting a11y support for usability research**, submit a research support request next. <br> [Open an a11y research support request](https://github.com/department-of-veterans-affairs/va.gov-team/issues/new?assignees=coforma-terry%2Cangelafowler82&labels=508%2FAccessibility%2C+sitewide+CAIA%2C+sitewide+accessibility%2C+CAIA-a11y-research&template=caia-a11y-research.yaml&title=%5BCAIA+A11y+Research%5D%3A+Team+name%2C+product+name)
- [ ] **If you are requesting content support**, please share your content source of truth (preferably as a SharePoint document).
### CAIA operations
- [x] Initial Review - @coforma-terry and @strelichl
- [x] Attend Kickoff 2/21/2024 (Terry and Lily)
- [ ] Attend Midpoint Review 10:30 a.m. ET Friday, 2/23/2024
### CAIA a11y tasks
- [x] Attend Kickoff 2/21/2024 (Sara, Evan and Terry)
- [x] Design Review - [Figma Designs V2](https://www.figma.com/file/7W55oNwdVXvXOTI9SaFzQ7/686c-Add-or-Remove-Dependents?type=design&node-id=319-47346&mode=design&t=iWU0j0ylBz1z2GED-0) (option before Midpoint) @EvanAtCoforma
- [ ] https://github.com/department-of-veterans-affairs/va.gov-team/issues/76841
- [x] Attend Midpoint Review 10:30 a.m. ET Friday, 2/23/2024 (Optional) @EvanAtCoforma
- [x] Share link to [accessibility review](https://github.com/department-of-veterans-affairs/va.gov-team/issues/75068#issuecomment-1960218541) (completed prior to Midpoint) @EvanAtCoforma
- [x] **Weekly Design Sync:** @EvanAtCoforma requested to be added weekly design sync with Dependent Management and Julie Strothman
- [ ] Review Brian's feedback from [Midpoint in CC ticket](https://github.com/department-of-veterans-affairs/va.gov-team/issues/77234) @evanatcoforma
- [ ] Sync with Team post midpoint re: Staging Prep Option
- [ ] Assist team with Staging Prep (as needed) `CONNECT STAGING ARTIFACT TICKET TO THIS TASK LIST`
### CAIA content tasks
- [x] Attend Kickoff 2/21/2024 (Katherine and Lily)
- [ ] Requested content source of truth (Sharepoint) of text within the tool in KO 2/21/2024
- [ ] Attend Midpoint Review 10:30 a.m. ET Friday, 2/23/2024 (Optional)
- [ ] https://github.com/department-of-veterans-affairs/va.gov-team/issues/76831
- [ ] https://github.com/department-of-veterans-affairs/va.gov-team/issues/76923
- [ ] https://github.com/department-of-veterans-affairs/va.gov-team/issues/80538
- [ ] https://github.com/department-of-veterans-affairs/va.gov-team/issues/85759
### CAIA IA tasks
- [x] Attend Kickoff 2/21/2024 (Jenny)
- [x] Attend Midpoint Review 10:30 a.m. ET Friday, 2/23/2024 (Optional)
steele-lm commented 8 months ago

cc @ajialeilani and @jstrothman

ajialeilani commented 8 months ago

Hi @strelichl @coforma-terry I'm curious about what kind of timeline we can expect from the review. We should have finalized designs in Figma a week from now

strelichl commented 8 months ago

@ajialeilani Thanks for that background, let me take a look on our end and I'll follow up tomorrow

strelichl commented 8 months ago

@ajialeilani As a first step, we'd like to set up a kickoff call to go over this work (and check in on the status of 686 work overall, I know we have a few other related tickets on our board). We have availability 2/21 at 12:00-12:30 and 12:30-1pm Eastern, would either of those work for you?

ajialeilani commented 8 months ago

@strelichl 12-12:30 on 2/21 would be great—thank you.

If I have more specific questions before then, can I ask them here or is it better to wait until office hours?

strelichl commented 8 months ago

@ajialeilani Here works! If it ends up being complicated I'll make sure the right person can be available during office hours to answer then.

steele-lm commented 7 months ago

@ajialeilani Takeaways from CAIA kickoff:

ajialeilani commented 7 months ago

@strelichl forwarded the invite to midpoint. Let me know if you don't see it for some reason.

strelichl commented 7 months ago

Noting from kickoff 2/21:

EvanAtCoforma commented 7 months ago

Hey @steele-lm and @strelichl , the accessibility review for the Figma prototypes is complete. Please let me know if you have any issues with the feedback so I can provide clarification. Thanks!

ajialeilani commented 7 months ago

Hi @strelichl @coforma-terry @aprocik1 do you have an idea of when you'll be able to start review? I've marked off the portions of the mockup still awaiting answers from SMEs with red annotations, and I'll be integrating midpoint feedback today and tomorrow.

I also heard about the possibility of keeping the source of truth in Figma rather than creating a Sharepoint document if your team is provided edit access to the Figma file. Is that a possibility here?

cc @juliepedtke

aprocik1 commented 7 months ago

Thanks for following up, @ajialeilani. Our goal is to start reviewing your form next week. We've talked about content sources of truth as a team with Beth and Danielle. For smaller projects, we're exploring Figma as a source of truth. Since this is a bigger project, we'd like to use a SharePoint document to record content recommendations for future reference. Let me know if that works for you.

ajialeilani commented 7 months ago

@aprocik1 Thanks for your update. That makes sense—it is a bit, meandering form. I'll have a Sharepoint doc ready for you by Monday.

ajialeilani commented 7 months ago

Hi @aprocik1 do ya'll have a template for a Sharepoint SoT? Something that covers error messages and other dependent states?

ajialeilani commented 7 months ago

Hi @aprocik1 @katherine-fung—regarding a hard deadline for this review, this is rather urgent due to the V3 changeover in May and other projects that stakeholders are eager to see implemented after this one. Given that it's our team's top priority, we're curious what would be realistic for you. We'll also meet with our front-end team soon and it's possible a more specific deadline will come out of that.

aprocik1 commented 7 months ago

@ajialeilani, thanks for following up. Katherine and I are actively working on this project. Our goal is to offer all our content recommendations by EOD Friday 3/29.

katherine-fung commented 6 months ago

Hi @ajialeilani @steele-lm @jstrothman,

Our team has made content recommendations for the 686c/674 in the source of truth document: https://dvagov.sharepoint.com/:w:/r/sites/vaabdvro/Shared%20Documents/Dependents%20Management/content-and-screenshots/686c_674%20Content%20source%20of%20truth.docx?d=w2c65a672bc3948b3a36ff8047f571c11&csf=1&web=1&e=xox3UV

Notes:

cc @aprocik1 @strelichl

katherine-fung commented 6 months ago

One more note @ajialeilani @steele-lm @jstrothman - when we share this with SMEs for review, could we ask them to focus on the accuracy of the copy? We've made specific choices here for plain language (i.e. the PDF uses the word "affidavit" and we're suggesting "signed statement" instead), active voice, and VA.gov style standards. We're happy to make changes to make copy more accurate, but it may save the SMEs time reviewing if they don't edit for style or voice.

ajialeilani commented 6 months ago

Thank you @katherine-fung! I second that approach.

ajialeilani commented 5 months ago

@strelichl @aprocik1 I've updated the Figma files with content from the source of truth with a few changes I'd ask you to review when you get the chance:

aprocik1 commented 5 months ago

@ajialeilani, thanks for this request. @katherine-fung and I will review these updates in the next few days. We'll tag you in another comment when we're done.

ajialeilani commented 5 months ago

Thanks, @aprocik1! One more thing—we were curious about the reason for aria-live-polite rather than alerts for conditional messaging about files that will need to be submitted. We know 527EZ uses alerts for similar messaging. Are we not doing the same mainly to avoid alert fatigue?

jstrothman commented 5 months ago

@aprocik1 @ajialeilani Here's an example in Figma of the alerts we use in the Pension 527EZ

katherine-fung commented 5 months ago

Hey @ajialeilani, I've reviewed most of these changes and they look good.

I do have a few questions:

  1. link to the Figma comment
  2. For the header "[Student’s name]’s income received in the year the school term begins," is this referring to the student's income in the year the CURRENT school term begins? I just realized on re-reading this may seem vague to some users, so I may tweak this to be more clear.
  3. How should I be looking at the flow for adding one or more children from our various groups? I see the screens with checkboxes marked, but I don't see anything else after that. Is that right?

Thanks!

cc @aprocik1

katherine-fung commented 5 months ago

Hi @ajialeilani @jstrothman,

Our guidance is continously evolving as we work on VA products. We learned a lot of lessons from the pension form and other projects since. After consulting with the a11y specialists on CAIA, we think the best solution here is to announce new information without using alerts, as you mentioned, to avoid alert fatigue.

Here's the advice from one of our a11y specialists back in March:

"You can programmatically set focus to it using JavaScript so users are immediately directed to the new content and can hear it being announced. also add aria-live=polite to it. This attributes a good choice as it allows the screen reader to finish its current announcement before announcing the new content. No need for an alert imo"

Let us know if you have any questions. Thanks!

cc @aprocik1

ajialeilani commented 5 months ago

Thanks for looking these over @katherine-fung—

  1. SSN and where was the child born should have been separated. I've made the correction and resolved the comment.
  2. That header in the PDF refers to question 11 " OFFICIAL BEGINNING DATE OF REGULAR TERM OR COURSE," which Kayce confirmed to be "Date of whatever term they started." So I understand the headings in financial info to be "First year you attended school" and "The following year."
  3. I'm still working on the flow. I'll ping you when it's ready.
ajialeilani commented 5 months ago

@katherine-fung @aprocik1 are either of you opposed to me updating the H1/breadcrumb to

File a claim to add or remove dependents on your VA benefits

and putting in a request with Lighthouse to have the title in the Claim Status Tool (eventually) align with that?

ajialeilani commented 4 months ago

Hi @katherine-fung @aprocik1

I reviewed the confirmation and reminder emails that go out through VA Notify in connection with 686c/674. I've added changes to the bottom of the Source of Truth doc. I'll post them here as well with screenshots of the original content.

Thanks!

Confirmation email

[H1] We’ve received your claim to add or remove dependents on your VA benefits

Dear ((first_name)),

Your claim to add or remove dependents on your VA benefits has been submitted for review. You don’t need to do anything unless we send you a letter asking for more information. Once we process your claim, we’ll mail you a letter with our decision.

You can also check the status of your claim online. [Color link] Check the status of your claim online

Note: It may take 7 to 10 days after you apply for your claim to appear online. [card] Application details: Claim to add or remove dependents on your VA benefits (VA Forms 21-686c and/or 21-674) Date submitted: ((date)) [end card] Thank you, VA You’re receiving this email because you started an application on [VA.gov](http://va.gov/). Please don’t reply to this email. If you need to contact us, visit [va.gov](http://va.gov/) or call [800-827-1000](tel:8008271000). We’re here Monday through Friday 8:00 a.m. through 9:00 p.m. ET. ### Reminder email [H1] You have an unfinished claim on [VA.gov](http://va.gov/) Dear ((first_name)), We’re writing to let you know that you have an application still in progress. Make sure you complete your application so we can properly process your request. [Card] Claim to add or remove dependents on your VA benefits (VA Forms 21-686c and/or 21-674) [color link] Continue your claim Application expires on ((date)) [end card] Thank you, VA You’re receiving this email because you started an application on [VA.gov](http://va.gov/). Please don’t reply to this email. If you need to contact us, visit [va.gov](http://va.gov/) or call [800-827-1000](tel:8008271000). We’re here Monday through Friday 8:00 a.m. through 9:00 p.m. ET. ![image (24)](https://github.com/department-of-veterans-affairs/va.gov-team/assets/127963233/67ca9a03-7e4e-4124-b708-dec78412adf6) ![image (25)](https://github.com/department-of-veterans-affairs/va.gov-team/assets/127963233/c8814a3b-8682-4225-b9b1-9a56c6a382dd) cc @strelichl

ajialeilani commented 4 months ago

Hi @katherine-fung @aprocik1 ,

Couple of questions about 21-674 that surfaced during PDF mapping:

  1. Can I add an "Other" with a conditional text field option to the benefit/program question to cover for if this list is not exhaustive:

    Screen Shot 2024-05-23 at 11 08 29 AM Screen Shot 2024-05-23 at 12 43 35 PM
  2. Can you confirm which question in the PDF this question is equivalent to if any?

When did the student  enroll in the federal education program or school?

Screenshots for reference:

Screen Shot 2024-05-23 at 12 54 15 PM Screen Shot 2024-05-23 at 12 49 10 PM

cc @strelichl @steele-lm

katherine-fung commented 4 months ago

Hi @ajialeilani!

  1. Yes, it's fine to add "Another program" as an option to that question. In the conditional field, we can just say, "Briefly list any other programs..." (I don't think VA.gov uses parentheses to indicate singular/plural - I could be wrong about this, but it's also just fine to use the plural).

  2. Looking at this now, I'm actually not sure. It might be trying to ask the PDF question 9c "Date payments began." Is there another question in the online form that asks when payments began? If there is already a different question in the online form that asks when payments began, then I'm really not sure why we put "When did the student enroll in the federal education program or school?" question in the online form. (and we could probably remove it??)

ajialeilani commented 4 months ago

Thanks @katherine-fung. I'll add "Another program" with the conditional field copy without parentheses. And we do ask for date payments began on the page following the programs checkbox group, so I'll remove the "When did the student enroll..." question.

ajialeilani commented 4 months ago

Hi @katherine-fung,

Here are the latest updates to a flow for adding one or more children. Let me know if this is decipherable / aligns with your vision.

cc @strelichl @aprocik1

katherine-fung commented 4 months ago

Hi @ajialeilani! The flow looks great, and aligns with the content source of truth. Thanks so much for working with us to implement the changes!!

ajialeilani commented 4 months ago

Hi @katherine-fung I added hint text to the school/program question (equivalent to 9A) to further distinguish it from the program/benefit question (equivalent to 9B) based on Brandi's feedback (pictured below). We were confused looking at this section during PDF mapping and concerned Veterans would be confused also. Let me know if this addition makes sense or if you think the labels are enough or if there are other opportunities to further clarify program/benefit vs. school/program.

cc: @strelichl @aprocik1

Screen Shot 2024-06-07 at 11 40 42 AM Screen Shot 2024-06-07 at 11 36 43 AM Screen Shot 2024-06-07 at 11 36 27 AM Screen Shot 2024-06-07 at 11 26 30 AM
katherine-fung commented 4 months ago

Thanks for the clarification @ajialeilani! EDITED: In that case, do you think tweaking the question this way helps provide enough distinction?

What's the name of the school or trade program the student attends? (trying to incorporate the hint text into the question, and eliminate "federally funded" which might imply benefit name)

ajialeilani commented 4 months ago

Hey @katherine-fung ! I think that's an improvement. I'll update the mockups. Thank you!

ajialeilani commented 4 months ago

Hi @katherine-fung @strelichl - just wanted to check in to see if you'd gotten a chance to look at our reminder and confirmation email updates. If not, do you have an estimate of when you'd be able to review them? Many thanks for all your work on this!

katherine-fung commented 4 months ago

Hi @ajialeilani! I'm working on these emails today.

katherine-fung commented 4 months ago

Hi @ajialeilani,

Our team has reviewed and edited the confirmation email copy in the Sharepoint source of truth.

Our team is in the process of editing the template for reminder emails for VA forms. This will be ready well ahead of the planned August/Sept launch for the form updates. I'll let you know when we've edited the reminder email for the 686c/674.

cc @steele-lm @aprocik1 @strelichl

ajialeilani commented 3 months ago

Hi @katherine-fung @aprocik1 @strelichl -

Our SMEs let us know that we need to include a "Remarks" section to 674 for form parity, which I've added here. Would love your review / any recommendations you can make as far as how to handle "Remarks" or how other forms do so.

According to the PDF, the remarks section is specifically for section III overflow (which is already being captured), and if the student has school-related expenditures that could be deducted from their net worth (for Pension recipients). But it may be that we need to keep it more general to capture other Veteran remarks.

Thanks!

aprocik1 commented 3 months ago

@ajialeilani, I just left you a Figma comment with a recommendation and question. Thanks for your patience!

katherine-fung commented 3 months ago

Hi @ajialeilani,

I've reviewed the reminder email content in the SOT doc, and left recommendations there. I've also tweaked the confirmation email copy to use the word "request" instead of "claim" as I mentioned on Slack.

https://dvagov.sharepoint.com/:w:/r/sites/vaabdvro/_layouts/15/Doc.aspx?sourcedoc=%7B2C65A672-BC39-48B3-A36F-F8047F571C11%7D&file=686c_674%20Content%20source%20of%20truth.docx&action=default&mobileredirect=true

For context, our team hasn't finalized a template for reminder emails yet, and we're not sure of our timeline for doing so. But we wanted to get you the copy for this specific email. At some point in the future, once we have a template, we may revisit all the reminder emails for VA forms to make sure they align with the new template.

Thanks for your patience, and let me know if you have any questions!

cc @aprocik1

strelichl commented 2 months ago

@steele-lm I understand you're planning to launch incrementally in August or September? Let me know if you have dates for that yet--I'd like to set up a sync for us to coordinate the process for widget work. Thanks!

steele-lm commented 2 months ago

@strelichl Thanks for reaching out! The launch of our phase 1 (backend) changes was delayed, so we're now tracking to have our phase 2 (front end) changes out sometime in the Sept/Oct time frame. How far out would you like to meet? I can stick a reminder on my scheduled to touch base at that point!

strelichl commented 2 months ago

@steele-lm If we could get a month of lead time that would be ideal. Thanks!

ajialeilani commented 2 weeks ago

Hi @strelichl —

We recently had to update our List & Loop patterns in our designs from the single page to the preferred multi-page pattern. These updates included some minor content changes, so we wanted to make you aware. Here are the pages where changes were made (content changes are mainly to H3 headers and button copy):

cc @steele-lm