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

Midpoint Review - Content Feedback - Modernized Check-in, Appointments, Travel Claims for Past Appointments #92865

Closed KKitagawa-Bosch closed 1 month ago

KKitagawa-Bosch commented 2 months ago

Next Steps for the VFS team

Thoughts/questions

-

Feedback

Practice areas will document their feedback on the VFS-provided artifacts following the Must, Should, and Consider Framework. Platform Governance reviewers may also provide additional notes that don’t comment on the artifacts themselves but are important for implementation (eg. engineering/coding notes).

Governance team actions

benbrasso-agile6 commented 2 months ago

Must: in the past appointments section, one bulleted list has bold tags while another does not. I think you can make an argument for either option, but they should be consistent

Peter

Must: in the penalty statement, the text currently reads "a fine, or imprisonment, or both." The middle item in the list does not need the "or".

Micah

"are you claiming only mileage" is a bit formal; "claiming only mileage" would align better with plain language standards

Micah

Consider: there are a few places in the copy where extremely short sentences are used that, while not technically out of guidance, could be perceived as terse or choppy to a reader. Consider combining sentences when the two sentences share a subject, object, or verb.

Micah, this is where we've been tagging you in this Figma wireframe.

micahtaylor commented 1 month ago

I've addressed the Consider and am reaching out to CAIA about the Should as I have some reservations about changing it but am validating that reservation.

benbrasso-agile6 commented 1 month ago

We'll talk to Peter and Appts FE UX Team this week about the Must

loripusey commented 1 month ago

Hey team! Please add your planning poker estimate with Zenhub @benbrasso-agile6 @cgednalske @zach-park

benbrasso-agile6 commented 1 month ago

FYI, this would be for pointing the first Must feedback that we'll pair with Appts Team on

benbrasso-agile6 commented 1 month ago

Changed the must for headings - https://www.figma.com/design/RzugGEmu4drhCSHTyQ6hjl/Simple-mileage-only-travel-pay-claim-submission?node-id=2160-2072&t=eMbpPmJ6uz8UYmQP-4

micahtaylor commented 1 month ago

Should: "are you claiming only mileage" is a bit formal; "claiming only mileage" would align better with plain language standards

After talking it through with CAIA I am opting to keep this content as is.

My two items are addressed.

benbrasso-agile6 commented 1 month ago

@micahtaylor how are we handling the penalty statement must feedback?

micahtaylor commented 1 month ago

I saw Peter's name over that item and skipped right over it. Realizing now that his name is under the first item. My mistake. I'll pick it up.

micahtaylor commented 1 month ago

Already done. Closing!