Capitalization: Adds all-caps exception guidance (#5719)

* docs: Capitalization: Adds all-caps exception guidance

Adds a new 'Exceptions where we use all caps' section to the capitalization
page with a restrictive allowlist (eyebrow text labels and Button - Icon labels
only). Includes a brief accessibility note about legibility. Adds
cross-references from the typography eyebrow section and button-icon page.

Closes #4403

* Update src/_content-style-guide/capitalization.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/_content-style-guide/capitalization.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/_foundation/typography.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/_components/button/button-icon.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Refine language for button-icon component documentation

Danielle edits

* Revise capitalization guidelines for clarity

Clarify capitalization rules and improve readability.

* Refine eyebrow component description for clarity

* Clarify instructions for icon and label requests

Updated instructions for requesting new icons and labels.

* Update src/_components/button/button-icon.md

Co-authored-by: Dan Brady <danbrady@users.noreply.github.com>

* Update src/_components/button/button-icon.md

Co-authored-by: Dan Brady <danbrady@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Danielle Thierry <62957278+DanielleThierryUSDSVA@users.noreply.github.com>
Co-authored-by: Dan Brady <danbrady@users.noreply.github.com>

Author: 4 people

src/_components/button/button-icon.md

@@ -51,7 +51,7 @@ anchors:
 
 ### How this component works
 
-* **Icon plus uppercase label.** These buttons are composed of an icon and an uppercase label. The label is a verb that represents an action that the user is taking. Because the visual style of this button uses uppercase text, labels must be very concise actions and thus are limited to one or two words only. For example, "Change file", "Delete", and "Cancel".
+* **Icon plus action label.** These buttons are composed of an icon and a concise label. For the label, use a verb that describes the action the person is taking, and aim to limit the label text to 1 or 2 words. For example, "Change file", "Delete", or "Cancel". The component’s visual style renders labels in uppercase, but authors should always provide label text in sentence case. Refer to [Capitalization]({{ site.baseurl }}/content-style-guide/capitalization) for guidance on when we permit all caps in visual treatments.
 
 ## Requesting new instances
 
@@ -61,7 +61,7 @@ The 3 examples above are the only currently approved instances of this component
 
 ## Content considerations
 
-* **Delete is preferred to remove.** We prefer words that describe exactly what will happen when you tap or click. Note: Currently, icon and button labels are hard-coded into the component. New icons and labels must be requested following the instructions above.
+* **Use the verb that describes exactly what will happen when the person takes the action.** For example, use "Delete" instead of "Remove" for when the action will delete a file. Note: Currently, icon and button labels are hard-coded into the component. You must follow the [instructions to request any new icons or label](#requesting-new-instances).
 
 ### Button labels
 

src/_content-style-guide/capitalization.md

@@ -13,13 +13,25 @@ Use sentence case capitalization for most content, including page titles, headin
 
 ### Exceptions where we use title capitalization
 
-- Proper nouns (example: branded terms like "VA.gov," official program names, state names, names of federal agencies, days of the week and months, compositions such as titles of books, etc.)
-- The word “Veterans”
-- Global navigation, top menu labels (VA Benefits and Health Care; About VA; Find a VA Location)
+- Proper nouns (such as branded terms like "VA.gov," official program names, state names, names of federal agencies, days of the week and months, and titles of books)
+- The word “Veteran” or "Veterans"
+- Global navigation and top menu labels (such as VA Benefits and Health Care, About VA, and Find a VA Location)
 - For mobile app native actions, use title case for iOS and all caps for Android
 
+### Exceptions where we use all caps
+
+On VA.gov web pages and components, avoid all caps for any purpose except the exceptions listed here. Longer uppercase text reduces legibility and can be harder to read for people with cognitive disabilities or low vision. 
+
+We permit all-caps text only for Android mobile app native actions and these specific web components:
+
+- [Eyebrow]({{ site.baseurl }}/foundation/typography#eyebrow) text labels
+- [Button - Icon]({{ site.baseurl }}/components/button/button-icon) labels
+
+Authors should still enter these labels in sentence case. The components will render them in all caps through styling.
+
 ### Exceptions where we use initial capitalization
-- SEO title tags (example: VA Prescription Refill And Tracking \| Veterans Affairs). See [Writing for SEO]({{ site.baseurl }}/content-style-guide/seo) for more information.
+
+- SEO title tags (example: VA Prescription Refill And Tracking | Veterans Affairs). Refer to [Writing for SEO]({{ site.baseurl }}/content-style-guide/seo) for more information.
 
 <div class="do-dont">
 <div class="do-dont__do">

src/_foundation/typography.md

@@ -238,7 +238,7 @@ Do not use monospace fonts for phone numbers, zip codes, dates, or other data th
 
 {% include snippet.html content='html/eyebrow-card.html' %}
 
-The eyebrow sits above a heading and provides a label for a sequence of pages in a process or for groups of related content, such as multiple cards. 
+The eyebrow sits above a heading and provides a label for a sequence of pages in a process or for groups of related content, such as multiple cards. The eyebrow component renders its text in uppercase through styling. Authors should still always enter label text in sentence case, not in ALL CAPS. Refer to [Capitalization]({{ site.baseurl }}/content-style-guide/capitalization) for guidance on when we permit all caps.
 
 ### When to use
 - Use the eyebrow when you implement the [Help users to complete a sub task]({{ site.baseurl }}/patterns/help-users-to/complete-a-sub-task) pattern.