About
What's new?
What’s Changed
- chore: update releases for 2026-10-30 by @Amy-Leadem in #7362
- Progress Indicator - Navigation: Adds first-pass component documentation by @Damian-Jimenez in #7220
- Upgrade packages for component-library v56.25.0 by @Ryan-Munsch in #7364
- 📊 Update metrics dashboard data - 2026-10-30 by @Amy-Leadem in #7363
- Save-in-progress docs suggestions by @Robert-Hasselle in #7370
- Save-in-progress: Document what happens when a user returns to a draft form by @Jeana-Clark in #7367
- Alert, My VA templates: Updates Action required guidance by @Matthew-Dingee in #7356
- Breadcrumbs, Process List: Adds My VA first segment and error status guidance by @Matthew-Dingee in #7357
- Upgrade packages for component-library v56.25.1 by @Ryan-Munsch in #7372
- Side Navigation: Adds My VA navigation guidance and ADR 012 by @Matthew-Dingee in #7352
- Header: Adds guidance for the va-header-navigation web component by @Matthew-Dingee in #7374
- Update prefilled information to best practice by @Robert-Hasselle in #7375
- Update dependencies for component-library v56.25.2 by @Ryan-Munsch in #7387
- Global: Remove Bitter, Source Sans, and ‘serif’ references and tokens and update related documentation from package bump by @DANIEL-BRADY in #7386
- Header guidance alignment with storybook and code by @Jeana-Clark in #7397
- Header: Clarify source of links and overrides by @Jeana-Clark in #7401
- Authenticated home page: Adds error states guidance for Action required and Updates by @Matthew-Dingee in #7403
- Bump nokogiri from 1.19.4 to 1.19.5 in the bundler group across 1 directory by @dependabot[bot] in #7411
- Update auth template guidance to refer to need help component by @Jeana-Clark in #7410
- Scripts: Adds Figma link rewrite script for Figma for Government by @Derek-Wang in #7361
- Update dependencies for component-library v56.25.3 by @Amy-Leadem in #7413
- Tokens: Add subgroups for better organization, display, and scannability by @DANIEL-BRADY in #7412
- Email: Adds VA Notify email template QA checklist by @Barbara-Denney in #6732
- Alert: Adds avoiding stacked alerts guidance by @Matthew-Dingee in #7424
- Bump addressable from 2.9.0 to 2.9.1 in the bundler group across 1 directory by @dependabot[bot] in #7428
- fix(imposter-scan): treat va-platform-frontend as the blanket reviewer by @Kerry-ann-Minott in #7407
- Fix update-releases workflow: use GITHUB_TOKEN for create-pull-request by @DANIEL-BRADY in #7434
- Fix update-releases workflow: restore API auth header and stop wiping the release cache by @DANIEL-BRADY in #7436
- va-need-help: add approved examples to content considerations by @Jeana-Clark in #7426
- Text input: Adds guidance on when to hide required text by @Barbara-Denney in #7409
- va-header-navigation content edits from content team by @Jeana-Clark in #7418
- chore: update releases for 2026-11-17 by @Amy-Leadem in #7446
New Contributors
- @Damian-Jimenez made their first contribution in #7220
- @Kerry-ann-Minott made their first contribution in #7407
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/2026-10-30…2026-11-17-2
What’s Changed
- 📊 Update pattern adherence data - 2026-10-19 by @Amy-Leadem in #7237
- chore: update releases for 2026-10-19 by @Amy-Leadem in #7238
- Upgrade component-library to 56.19.0 by @Kerry-Powell in #7244
- Adds styling guidance for headings in screenshot-to-html skill to be not programmatic by @Derek-Wang in #7040
- Tag - Status: Adds draft as a neutral status use by @Barbara-Denney in #7248
- Add va-action-list accessibility test list by @Amy-Leadem in #6880
- Metrics tests: Fixes silent pass on empty chart check by @Matthew-Dingee in #7253
- Update css-library and web-components packages for component-library v56.20.0 release by @Ryan-Munsch in #7260
- Authenticated home page: Clarifies zero counts in Updates by @Matthew-Dingee in #7295
- 📊 Update metrics dashboard data - 2026-10-23 by @Amy-Leadem in #7269
- 📊 Update pattern adherence data - 2026-10-26 by @Amy-Leadem in #7284
- Update component-library packages for latest release by @JAMI-GIBBS in #7296
- Skills: Adds design-staging-review skill for Collaboration Cycle Staging Reviews by @Matthew-Dingee in #7262
- Bump nanoid from 3.3.17 to 3.3.20 by @dependabot[bot] in #7298
- Staging review skill: Adds shareable HTML findings export by @Matthew-Dingee in #7304
- Doc-queue and guidance-grooming skills: Updates for va.ghe.com and the current epic by @Matthew-Dingee in #7311
- Action required window: Adds missing profile information exception by @Matthew-Dingee in #7326
- [DONT MERGE TILL AFTER MIGRATION] Figma: Updates links to Figma for Government (figma-gov.com) by @Barbara-Denney in #7251
- Doc skills: Treats the groomed label as already groomed by @Matthew-Dingee in #7329
- Category pages: Adds partial-load, empty-state, and heading icon guidance by @Matthew-Dingee in #7331
- Action List: Updates Figma link to figma-gov.com by @Derek-Wang in #7342
- va-action-list: Document “Show more” toggle by @Jeana-Clark in #7339
- Metrics: Adds focused hardcoded typography report by @Matthew-Dingee in #7132
- Guidance skills: Adds content style guide review step by @Matthew-Dingee in #7359
- Docs: Fixes broken internal links by @Matthew-Dingee in #7358
- Process List: Adds design decision and guidance for error and action-needed states by @Matthew-Dingee in #7328
- Update site for Public Sans by @JAMI-GIBBS in #7309
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/2026-10-19…2026-10-30
What’s Changed
- chore: update releases for 2026-10-06 by @Amy-Leadem in #7167
- Updates form step screenshots by @Jeana-Clark in #7169
- Update component-library to latest - v56.16.2 by @JAMI-GIBBS in #7174
- Bump component-library package for component-library v56.17.0 release by @Ryan-Munsch in #7198
- Metrics tests: Removes hardcoded counts and runs suites in CI by @Matthew-Dingee in #7188
- 📊 Update metrics dashboard data - 2026-10-09 by @Amy-Leadem in #7190
- 📊 Update pattern adherence data - 2026-10-12 by @Amy-Leadem in #7193
- Update component-library packages for latest release: v56.18.0 by @JAMI-GIBBS in #7200
- Create september-2026.md: Added Sept 2026 changes by @Lauren-Vocke in #7204
- Metrics: Runs the imposter component scan in the weekly workflow by @Matthew-Dingee in #7118
- Dates: Add timestamp display guidance as reusable partial by @Barbara-Denney in #6559
- HTML examples: Standardizes screenshot-to-HTML mockups by @Barbara-Denney in #7186
- 📊 Update metrics dashboard data - 2026-10-16 by @Amy-Leadem in #7233
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/2026-10-06…2026-10-19
What’s Changed
Fixes
Header navigation
- Header navigation: Sync links with
generated/headerFooter.jsonby @Jeana-Clark in #2457 - Header navigation: Convert account data to a static import by @Amy-Leadem in #2456
- Header navigation: Remove re-export of account and personal data by @Amy-Leadem in #2463
CSS Library
- CSS-Library: keep heading weight when content is wrapped in strong by @JAMI-GIBBS in #2454
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.25.2…v56.25.3
What’s Changed
⚠️ This is a breaking change for CSS-Library that removes the Source Sans Pro and Bitter typefaces and their associated tokens.
Removed
- CSS-Library
- Remove Bitter and the serif typography tokens and utilities by @JAMI-GIBBS in #2440
- Remove Source Sans Pro and its tokens and utilities by @JAMI-GIBBS in #2447
Fixes
- va-header-navigation
- Move sign out button to top of menu by @Amy-Leadem in #2448
- Header navigation: Enable wrap on header nav bar by @Amy-Leadem in #2446
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.25.1…v56.25.2
What’s Changed
Fixes
- Header navigation: Allow mobile menu to take over screen when open by @Amy-Leadem in #2433
- Header navigation - Make mobile menu full height in short viewports by @Amy-Leadem in #2443
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.25.0…v56.25.1
September 2026
Content style guide
Page titles and section titles
-
Added guidance on using unique section titles:
Make each section title unique. Each title should be different enough so people can quickly and easily tell the difference between the sections. This is particularly important for pages that include an On This Page component (table of contents).
- Moved section title bullet items on length and punctuation to a separate subsection, Length and punctuation (no changes to guidance)
- Made edits throughout to align with the style guide
Plain language - Don’t use idioms
-
Updated introduction to include euphemisms and colloquialisms and added a second sentence about using clear and direct language:
Idioms, euphemisms, and colloquialisms can be confusing, especially for someone whose first language isn’t English. Instead, use clear and direct language.
-
Added 2 new examples:
Like this
If you’re the surviving spouse, child, or parent of a Veteran whodiedfrom a service-related injury or illness, you may be eligible for VA Dependency and Indemnity Compensation (D.I.C.).Not this
If you’re the surviving spouse, child, or parent of a Veteran whopassed awayfrom a service-related injury or illness, you may be eligible for VA Dependency and Indemnity Compensation (D.I.C.).Like this
Am I eligible for a Survivors Pension as the child of adeceasedwartime Veteran?Not this
Am I eligible for a Survivors Pension as the child of alatewartime Veteran?
Readability and usability of VA digital content
Added new guidance on content in PDFs on VA.gov, including information on official VA forms, outreach materials, tool user guides, and benefit guides. The guidance explains our approach to PDFs for each type of content and alternate solutions when we don’t recommend posting or linking to PDFs. The guidance also explains the accessibility concerns and requirements we need to consider with PDFs.
Word list
-
Added 4 new entries:
active and inactive (for account status)
When referring to someone’s account status, use “active,” “inactive,” and “to make your account active again.”
e.g., i.e., and ex.
Avoid using “e.g.,” “i.e.,” or “ex.” to introduce examples. Instead, use words like “for example” or “like.”
etc.
Don’t include “etc.” in a list of examples. Use “like” or “for example” to introduce the examples. This indicates that it may not be a full list.
recipient
In general, avoid using “recipient.” Instead, reword the sentence to use “the person who received the benefit,” “the person who will receive the benefit,” or similar. There are some exceptions where “recipient” is part of an understood or official term, like “Medal of Honor recipient.” In those cases, it’s OK to use “recipient.”
-
Revised 1 entry:
healthcare
1 word, never hyphenated as a compound adjective (for example, “healthcare system”). Lowercase unless it’s part of the official name of a VA medical center.
Note: This change aligns with new AP guidance. We’re working on updating this from 2 words to 1 across our content. But you may still find instances of “health care” while we’re working on these updates.
Exception: Defer to the VA medical center’s official name, which may have “health care” as 2 words.