Open steele-lm opened 8 months ago
cc @ajialeilani and @jstrothman
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
@ajialeilani Thanks for that background, let me take a look on our end and I'll follow up tomorrow
@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?
@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?
@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.
@ajialeilani Takeaways from CAIA kickoff:
@strelichl forwarded the invite to midpoint. Let me know if you don't see it for some reason.
Noting from kickoff 2/21:
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!
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
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.
@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.
Hi @aprocik1 do ya'll have a template for a Sharepoint SoT? Something that covers error messages and other dependent states?
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.
@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.
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:
There are a few outstanding questions I have for SMEs. I've highlighted the relevant copy in aqua in the SOT, to note that we should return to this copy once we get clarification from SMEs about what the copy needs to ask. Let me know if you have any questions!
I made recommendations only to first version of the "introduction page (not authenticated)" in the Word doc. Please copy these recommendations over to other version of the introduction page for authenticated users, etc.
You'll see that I commented in the doc about needing static page content to provide information about what applicants need to submit in different use cases. We'll need to chat with Beth about how to best approach that static content.
cc @aprocik1 @strelichl
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.
Thank you @katherine-fung! I second that approach.
@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:
@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.
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?
@aprocik1 @ajialeilani Here's an example in Figma of the alerts we use in the Pension 527EZ
Hey @ajialeilani, I've reviewed most of these changes and they look good.
I do have a few questions:
Thanks!
cc @aprocik1
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
Thanks for looking these over @katherine-fung—
@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?
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!
[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
Hi @katherine-fung @aprocik1 ,
Couple of questions about 21-674 that surfaced during PDF mapping:
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:
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:
cc @strelichl @steele-lm
Hi @ajialeilani!
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).
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??)
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.
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
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!!
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
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)
Hey @katherine-fung ! I think that's an improvement. I'll update the mockups. Thank you!
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!
Hi @ajialeilani! I'm working on these emails today.
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
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!
@ajialeilani, I just left you a Figma comment with a recommendation and question. Thanks for your patience!
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.
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
@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!
@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!
@steele-lm If we could get a month of lead time that would be ideal. Thanks!
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
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.
insert description
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
@Terry Nichols
. We’ll reply within 24 hours to acknowledge receipt. We'll then review the artifacts in more detail and work with you to determine timing for collaboration. Depending on the work, we may schedule a kickoff meeting to better understand how we'll partner together.Tasks