Skip to content
This repository is currently being migrated. It's locked while the migration is in progress.

Commit 928db5b

Browse files
authored
Merge pull request #6052 from department-of-veterans-affairs/laurenvocke-va-patch-1
Create march-2026.md: Adding file for March 2026 content updates
2 parents e1ded12 + ef09ef1 commit 928db5b

1 file changed

Lines changed: 95 additions & 0 deletions

File tree

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
### Content style guide
2+
3+
#### [Bulleted and numbered lists](https://design.va.gov/content-style-guide/bulleted-lists)
4+
5+
Added guidance on what to consider when ordering bulleted lists:
6+
7+
> Bulleted lists generally don’t need to be in a specific order. But in some cases, you may want to consider ordering the list based on the type of list items.
8+
9+
> **Grouping like items**<p>
10+
Some lists may include sets of similar items. For example, a list of documents may include some documents related to education, some for personal information, and some for financial information. In this case, group each set of similar items together in the list.
11+
12+
> **Order of importance or level of urgency**<p>
13+
In some lists, certain items may be more important or urgent than others. In this case, order the list with the most important or urgent item first. Consider a numbered list if appropriate for the content.
14+
15+
> **Numerical**<p>
16+
In lists of dates, dollar values, percentages, or other numerical values, it may make sense to order the list from either high to low or low to high.
17+
18+
> **Alphabetical**<p>
19+
Use alphabetical order for lists of certain items, like medications or specific locations, that don't have another natural order. But don't default to alphabetical order for all lists.
20+
21+
#### [Punctuation and formatting](https://design.va.gov/content-style-guide/punctuation)
22+
23+
Added guidance on parentheses:
24+
25+
> **When to use parentheses**<p>
26+
• For short examples within a sentence<br>
27+
• To set off brief additional information (an aside) that helps readers understand the sentence, the context, or a specific word or phrase<br>
28+
• To introduce an acronym or abbreviation<br>
29+
• To add a VA form number after the form title<p>
30+
**When not to use parentheses**<p>
31+
Consider making the parenthetical a separate sentence in these cases:<p>
32+
• If the parenthetical is a full sentence on its own<br>
33+
• If the parenthetical is long or makes the sentence harder to understand
34+
35+
> **Plurals**<p>
36+
Don't use "(s)," "(es)," or "(ies)" at the end of a word to show a possible plural. Screen readers don't announce the parenthetical in a way that people can easily understand. Instead, use the plural version of the word. You can also reword the sentence to use "any" before the plural to mean 1 or multiple.
37+
38+
#### [Payments and debts](https://design.va.gov/content-style-guide/specific-topics-and-programs/payments-and-debts)
39+
40+
Updated the definition for balance:
41+
> **balance**<br>
42+
Use "balance" when you refer to the total amount owed for copay bills or overpayment debt.<p>
43+
**Like this:** Pay your full balance or request help by the due date on your collection letter or billing statement.
44+
45+
#### [Readability and usability of VA digital content](https://design.va.gov/content-style-guide/readability-and-usability)
46+
47+
Added this new page to the style guide. This page explains our approach to ensuring digital content is easy to find, understand, and use. And it explains our approach to readability scores.
48+
49+
#### [Sign in and identity verification](https://design.va.gov/content-style-guide/specific-topics-and-programs/sign-in-and-identity-verification)
50+
51+
- Added information on **ID.me** to the first **Considerations** bullet:
52+
> **ID.me** provides more flexibility for identity verification for Veterans in certain situations, such as living outside the U.S.
53+
- Updated the **identity verification** and **verify your identity** definition to specify that **ID.me** and **Login.gov** are accounts. And added information to the note about using "confirm" or "confirmation" when asking someone to check information they provided on a form (like a mailing or email address).
54+
55+
#### [Word list](https://design.va.gov/content-style-guide/word-list)
56+
57+
Updated these entries:
58+
59+
- **verify and verification:** Specified that **ID.me** and **Login.gov** are accounts
60+
- **Veterans Service Organization (VSO):** Fixed typo
61+
62+
Added these new entries:
63+
64+
> **balance**<br>
65+
Use "balance" when you refer to the total amount owed for copay bills or overpayment debt.<p>
66+
**Like this:** Pay your full balance or request help by the due date on your collection letter or billing statement.
67+
68+
> **community care**<br>
69+
Lowercase.
70+
71+
> **confirm or confirmation**<br>
72+
Use "confirm" or "confirmation" when asking a person to check the information they provided on a form or application, like an email address or mailing address. Avoid using the terms "verify" or "verification" in this context. We only use the terms "verify" and "verification" to describe the initial, one-time process of verifying your identity with an **ID.me** or **Login.gov** account.
73+
74+
> **discharge status (character of discharge)**<br>
75+
The discharge statuses are honorable, general, medical, other than honorable, bad conduct, dishonorable, officer, and entry-level separation. If you're grouping multiple statuses together, list each status.<p>
76+
• **Like this:** You may qualify for these benefits if you have an honorable, general, or medical discharge.<br>
77+
• **Like this:** You may qualify for these benefits if you have an honorable, general, or medical discharge. If you have a different discharge type, you may still qualify for some benefits.<br>
78+
**Like this:** If you have an other than honorable or bad conduct discharge, you may still qualify for some benefits.
79+
80+
> **MOVE! Weight Management Program for Veterans**<br>
81+
MOVE! is all capital letters, with an exclamation point at the end. There's no space between the "E" and the exclamation point. MOVE! isn't an acronym. After the first mention of the full formal program name, we can use "MOVE!" for all other mentions.
82+
83+
### Components
84+
85+
#### [Alert](https://design.va.gov/components/alert/)
86+
87+
- Added guidance on slim alert length:
88+
> Keep slim alerts to 100 characters (with spaces) when possible. If you have a slim alert that’s longer than 100 characters, contact the VA.gov content and IA team. The team will work with you to edit the alert or determine if we need to make an exception (up to 150 characters).
89+
- Made edits to the **Content considerations** to align with the style guide.
90+
91+
### IA
92+
93+
#### [VA website organization](https://design.va.gov/ia/va-website-organization)
94+
95+
This new section explains how and why we organize content on the main VA.gov website and key subdomains.

0 commit comments

Comments
 (0)