Staging Review finding: Incorrect link text for downloading government forms

[shiragoodman]

Need help? Please review how to read a Staging Review ticket. Tag @platform-governance-team-members on Slack if you need further assistance.

Product Information

Team: Education Data Migration Product: WEAMS Public Feature: WEAMS Public

Findings details

VA.gov Experience Standard - issue: User encounters content that is similar to other content on VA.gov. VA.gov Experience Standard - category: Consistency Launch-blocking: No Design System review: No Collab Cycle Reviewer: @kkitagawa-bosch (content)

Description

Throughout the pages, links to government forms are structured as "Get VA Form 22-0803 to download." These links should follow the format "Download VA Form 21P-530 (PDF)" per the VADS guidance

Link, screenshot or steps to recreate

Recommended action

Refer to the VADS guidance on Government Forms for details

References

• Accessibility Defect Severity: N/A
• WCAG Success Criteria: N/A
• Modality: N/A
• Design System Component: N/A
• Design System Pattern or Template: N/A
• Design System Foundation: N/A
• Content Style Guide: Government forms
• Context: N/A

---

Next Steps for the VFS Team

How did this touchpoint go? Give feedback on the Collaboration Cycle at any time.

• [ ] Questions? For the most timely response, comment on Slack in your team channel tagging @platform-governance-team-members with any questions or to get help validating the issue.
• [ ] Ticket ownership: If you believe that this issue is out of scope, not your team's responsibility, or a Design System issue, comment and tag @platform-governance-team-members on your team channel in Slack to provide an explanation and who you believe is responsible. The Governance team will follow up.
• [ ] Close this ticket when the issue has been resolved or validated by your Product Owner.

[skulka07]

Hello @shiragoodman @KKitagawa-Bosch, in the past, the link text was updated from "Get VA Form 22-0803 to print" to "Get VA Form 22-0803 to download" as per Erin's suggestions. Also, I see this this verbiage used on different pages across the VA.

https://www.va.gov/pension/apply-for-veteran-pension-form-21p-527ez/introduction

https://www.va.gov/housing-assistance/disability-housing-grants/how-to-apply/

[KKitagawa-Bosch]

@DanielleThierryUSDSVA any thoughts here? The example for links in the style guide seems pretty direct and clear to me, but if this language is being used elsewhere and the formatting is better for some IA reasons (@erinrwhite?) maybe this is another good candidate for an update in the style guide.

[erinrwhite]

The formatting guidance in the style guide is pretty proscriptive about this (emphasis mine here):

• Create space between different links. Clustering links together can make it hard for users to select the intended link, especially on a touch screen device, like a smartphone.
• In general, put a link on a separate line to help it stand out. Exception: Putting a link at the end of a sentence is OK if space is limited, like intro copy or alerts.

[skulka07]

Hello @erinrwhite, I will ensure to follow the formatting guidance, what about the verbiage of the link?

[erinrwhite]

@skulka07 I don't think we have a set-in-stone standard for this, but I really like the example from Storybook, Download VA form XX-XXXX (PDF, XX pages)