[Epic] Standards, style guide, and general documentation

[RLHecht]

High Level User Story/ies

As someone who works on VA.gov, I need to know the standards for content, IA, and accessibility so that the what I create or modify meets VA.gov standards.

As a Veteran, service member, or caregiver, I want my experience on VA.gov to be consistent, accessible, and free of errors.

Problem Statement

As the Sitewide Content, IA, and Accessibility team continues to iterate on VA.gov standards, we need to make sure the newest information is available to all resources working on VA.gov. This includes maintaining and adding to the VA.gov style guide and the design system, and creating documentation as needed.

Some of the content work will include:

• Adding topic-specific sections
• Building out error message dictionary
• Auditing and updating style guide
• Creating new content briefs as products are developed

Some of the IA work will include:

• Establishing and publishing standards for search best bets
• Adding IA guidance to applicable components in the design system
• Establishing taxonomy documentation

We will create individual epics to track each area of work.

Content-Related Tasks

Beta Give feedback

1. Error message style guide and dictionary iteration #34490
   sitewide CAIA sitewide content +2
   
2. [CAIA Content Support]: Content Style Guide: Make it easier for people who use the guide to quickly find latest updates #31245
   content style guide sitewide CAIA +2
   

   
3. [CAIA Content Support]: Content Style Guide: Add "latest updates" section to front page #31244
   content style guide sitewide CAIA sitewide content +3
   
4. [CAIA Content Support]: Content Style Guide: Add guidance about avoiding sub bullets to bulleted list entry #35671
   content style guide sitewide CAIA sitewide content +3
   
5. [CAIA Content Support] Content Style Guide: Add entry about how to use aria labels with extensions in phone number entry #54073
   accessibility content style guide sitewide CAIA sitewide content +4
   
6. [CAIA Content Support] Content Style Guide: Items to consider adding #19437
   content style guide sitewide CAIA sitewide content +3
   
7. Edits to PL section of style guide #58680
   content style guide sitewide CAIA +2
   
8. Update word list in style guide to make entries more prominent #54325
   content style guide sitewide CAIA sitewide content +3
   
9. Review and edit translation content readiness checklist #55680
   sitewide CAIA sitewide content vsa-translations-pages +3
   
10. Add "multifactor authentication" to style guide word list #33051
    November content style guide sitewide CAIA +3
    

    
11. Remove duplicate entries in style guide word list and confirm list is in alphabetical order #44955
    August content style guide sitewide CAIA sitewide content +4
    
12. Update word list entries in style guide so consistent language throughout #42399
    June content style guide sitewide CAIA sitewide content +4
    
13. Create debt section for style guide #51434
    January content style guide sitewide CAIA sitewide content +4
    
14. Audit the "How to update the content style guide" doc #75452
    +0
    
15. Refine guidance for using one/1 #82295
    0 of 4
    sitewide CAIA sitewide content +2
    
16. Content support for error messages for Ask VA health form - Contact/identity team #36493
    June sitewide CAIA sitewide CAIA-product support sitewide content sw-content-compose sw-content-data-discovery +6
    

    
17. Content + Accessibility: Work to define and document patterns/standards/examples #21100
    sitewide CAIA sitewide accessibility sitewide content +3
    

    
18. Define content standards: Preparing content for translation #21103
    CAIA-Translation content style guide sitewide CAIA sitewide content sw-content-strategy vsa-content-localization +6
    
19. Define and document nuances of plain and compassionate language #21104
    content style guide sitewide CAIA sitewide content +3
    
20. Determine privacy act modal content #21108
    sitewide CAIA sitewide content +2
    
21. Define content standards: Form intro pages #24391
    sitewide CAIA sitewide content sw-content-strategy +3
    

    
22. Create more guidance for UI content #40450
    +0
23. Define phase 1 content patterns for tool landing pages #20588
    content content style guide sitewide content sw-content-strategy +4
    
24. Updating Eligibility h3 question to be consistent across all hubs #10787
    November content planned-work sitewide content +4
    

    
25. Create template for content briefs #21102
    sitewide CAIA-product support sitewide content +2
    

a11y-Related Tasks

Beta Give feedback

1. [Epic] CAIA Accessibility Documentation #55956
   10 of 17
   Epic accessibility sitewide CAIA sitewide accessibility +4
   
2. [Epic] Content Style Guide a11y Support #64465
   3 of 4
   Epic content style guide sitewide CAIA sitewide accessibility sitewide content +5
   
3. WCAG 2.2 upgrade evaluation for VA.gov standards #67023
   sitewide CAIA sitewide accessibility +2
   

   
4. [Transfer to DST] a11y Discovery: Breadcrumb Link Cursor Event #53331
   design system sitewide CAIA sitewide IA sitewide accessibility +4
   
5. [a11y Review] Content Style Guide: Fix accessibility issues #59528
   content style guide sitewide CAIA sitewide accessibility sitewide content +4
   

   
6. [CAIA A11y Support]: Design System Team, Design System Date component #57845
   accessibility platform-design-system-team sitewide CAIA sitewide accessibility +4
   

   
7. Evaluate Figma's accessibility features per request of the design leads #57911
   sitewide CAIA sitewide accessibility sitewide content +3
   

   
8. Accessibility feedback for currency symbol addition to va-number-input from DST #55335
   sitewide CAIA sitewide CAIA-product support sitewide accessibility +3
   

   
9. [a11y documentation] Draft Testing Plan #71592
   sitewide CAIA sitewide accessibility +2
   
10. [a11y documentation] Benefit Hub Page Template: Review for Accessibility Considerations #74090
    12 of 12
    sitewide CAIA sitewide IA sitewide accessibility +3
    

Tasks

Beta Give feedback

We're having trouble rendering your tasklist, it's most likely has one of the following formatting errors:

• indented tasks (i.e. nested tasklist; support for this is coming!)
• an empty task (i.e. - [ ] on a line by itself)
• any empty new lines (before/after the tasklist or in between tasks)
• duplicate issue/pr links
• a draft task exceeds 512 characters

Please check the tasklists documentation for more information. 🔗 Feedback Discussion

Thank you for participating in the Private Beta ❤️

No tasks being tracked yet.

Multi-Discipline CAIA Tasks

Beta Give feedback

1. [a11y Support & CAIA Content Support] ARIA labels applied to telephone numbers in Drupal #60219
   0 of 12
   Drupal/CMS Issue cms sitewide CAIA sitewide accessibility +4
   

   
2. [a11y Support & CAIA Content Support] Content Style guide: Updates to phone numbers from Accessibility Team #54033
   content style guide sitewide CAIA sitewide CAIA-product support sitewide accessibility sitewide content +5
   

   
3. [a11y Support & CAIA Content Support] Content Style Guide: Accessibility update: Fix accessibility issues #64483
   content style guide sitewide CAIA sitewide accessibility sitewide content +4
   
4. Revise Sitewide CAIA intake request #60683
   sitewide CAIA sitewide IA sitewide accessibility sitewide content +4
   

   
5. Revise Sitewide CAIA touchpoint page on Platform website #59775
   sitewide CAIA +1
   

[sara-amanda]

@laurwill adding to CAIA GHP Epics too.