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
284 stars 206 forks source link

Staging Review finding: Content recommendations in opening paragraph #93682

Closed shiragoodman closed 1 month ago

shiragoodman commented 2 months ago

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: Transition Experience Product: Transition Experience MVP v1 Feature: V1 Transition Experience

Findings details

VA.gov Experience Standard - issue: User encounters content that does not meet best practices. VA.gov Experience Standard - category: Comprehension Launch-blocking: No Design System review: No Collab Cycle Reviewer: @kkitagawa-bosch (content)

Description

There are a few content issues in the introductory paragraph. Nothing is particularly "wrong" per the style guide, but significant improvements can be made.

Recommended action

(1) Change "this is a recommendation tool . . ." to be more active. "This tool does not determine eligibility" is clearer, then you can explain how users may determine eligibility elsewhere

(2) Move "welcome to VA" to the top, if anywhere. I don't think it's necessary, but it feels strange at the end of the second paragraph.

(3) Third paragraph does not need to be a separate paragraph and should be included in paragraph two.

References


Next Steps for the VFS Team

nkontrabecki commented 1 month ago

This ticket is closed 10/7/2024 because there is new text in the opening paragraph consistent with CAIA recommendations. Sprin3 Jira tickets 157, 158 and 175.