From 90aebec631361ccf5ecb64414b104b07b302d4fc Mon Sep 17 00:00:00 2001
From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com>
Date: Fri, 13 Mar 2026 14:52:15 -0400
Subject: [PATCH 1/2] docs(components): Standardize approach to accessibility
docs via design guidelines.
---
.../content/components/about-modal/about-modal.md | 3 +++
.../content/components/backdrop/backdrop.md | 7 -------
.../components/background-image/background-image.md | 7 -------
.../patternfly-docs/content/components/brand/brand.md | 7 -------
.../content/components/checkbox/checkbox.md | 3 +++
.../content/components/clipboard-copy/clipboard-copy.md | 5 ++++-
.../content/components/components-data.json | 4 ++--
.../components/context-selector/context-selector.md | 5 ++++-
.../components/expandable-section/expandable-section.md | 2 ++
.../content/components/menu-toggle/menu-toggle.md | 9 ---------
.../patternfly-docs/content/components/menu/menu.md | 3 +++
.../patternfly-docs/content/components/modal/modal.md | 3 +++
.../content/components/navigation/navigation.md | 5 ++++-
.../patternfly-docs/content/components/page/page.md | 2 ++
.../content/components/progress/progress.md | 5 ++++-
.../patternfly-docs/content/components/radio/radio.md | 3 +++
.../content/components/sidebar/sidebar.md | 5 ++++-
.../components/skip-to-content/skip-to-content.md | 7 -------
.../patternfly-docs/content/components/switch/switch.md | 5 ++++-
.../patternfly-docs/content/components/tabs/tabs.md | 3 ++-
.../content/components/text-area/text-area.md | 7 -------
.../patternfly-docs/content/components/title/title.md | 5 -----
.../content/components/tree-view/tree-view.md | 5 ++++-
23 files changed, 51 insertions(+), 59 deletions(-)
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/backdrop/backdrop.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/background-image/background-image.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/brand/brand.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/menu-toggle/menu-toggle.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/skip-to-content/skip-to-content.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/text-area/text-area.md
delete mode 100644 packages/documentation-site/patternfly-docs/content/components/title/title.md
diff --git a/packages/documentation-site/patternfly-docs/content/components/about-modal/about-modal.md b/packages/documentation-site/patternfly-docs/content/components/about-modal/about-modal.md
index 964eed7afe..b201d7c1e7 100644
--- a/packages/documentation-site/patternfly-docs/content/components/about-modal/about-modal.md
+++ b/packages/documentation-site/patternfly-docs/content/components/about-modal/about-modal.md
@@ -31,3 +31,6 @@ About modals are clicked into through a users interaction with a button, link, o
Provide access to an about modal using a help icon in the application masthead. Clicking the help icon will launch a dropdown menu. The help menu should always include an option labeled "About" that launches the about modal.
+
+## Accessibility
+For information regarding accessibility, visit the [about modal accessibility](/components/about-modal/accessibility) tab.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/components/backdrop/backdrop.md b/packages/documentation-site/patternfly-docs/content/components/backdrop/backdrop.md
deleted file mode 100644
index d5895f222d..0000000000
--- a/packages/documentation-site/patternfly-docs/content/components/backdrop/backdrop.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-id: Backdrop
-section: components
----
-
-## Accessibility
-For information regarding accessibility, visit the [backdrop accessibility](/components/backdrop/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/background-image/background-image.md b/packages/documentation-site/patternfly-docs/content/components/background-image/background-image.md
deleted file mode 100644
index 42f765772a..0000000000
--- a/packages/documentation-site/patternfly-docs/content/components/background-image/background-image.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-id: Background image
-section: components
----
-
-## Accessibility
-For information regarding accessibility, visit the [background image accessibility](/components/background-image/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/brand/brand.md b/packages/documentation-site/patternfly-docs/content/components/brand/brand.md
deleted file mode 100644
index dde5b09310..0000000000
--- a/packages/documentation-site/patternfly-docs/content/components/brand/brand.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-id: Brand
-section: components
----
-
-## Accessibility
-For information regarding accessibility, visit the [brand accessibility](/components/brand/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md b/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
index 861c20cc33..6a77aa0dfa 100644
--- a/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
+++ b/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
@@ -62,3 +62,6 @@ The main difference between a switch and a checkbox is that a switch changes an
-## Accessibility
+## Accessibility
-For information regarding accessibility, visit the [banner accessibility tab](/components/banner/accessibility).
+For information regarding accessibility, visit the [banner accessibility](/components/banner/accessibility) tab.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/components/breadcrumb/breadcrumb.md b/packages/documentation-site/patternfly-docs/content/components/breadcrumb/breadcrumb.md
index 11e407943d..15df7ee93a 100644
--- a/packages/documentation-site/patternfly-docs/content/components/breadcrumb/breadcrumb.md
+++ b/packages/documentation-site/patternfly-docs/content/components/breadcrumb/breadcrumb.md
@@ -26,4 +26,4 @@ Breadcrumbs should be placed underneath the masthead, at the top of the page. Th
## Accessibility
-For information regarding accessibility, visit the [breadcrumb accessibility](/components/breadcrumb/accessibility) tab.
+For information regarding accessibility, visit the [breadcrumb accessibility](/components/breadcrumb/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/button/button.md b/packages/documentation-site/patternfly-docs/content/components/button/button.md
index 2a58d990ea..f9a012949b 100644
--- a/packages/documentation-site/patternfly-docs/content/components/button/button.md
+++ b/packages/documentation-site/patternfly-docs/content/components/button/button.md
@@ -329,4 +329,4 @@ Use specific, action-focused labels that match what the user will see when they
## Accessibility
-For information regarding accessibility, visit the [button accessibility page](/components/button/accessibility).
+For information regarding accessibility, visit the [button accessibility](/components/button/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/calendar-month/calendar-month.md b/packages/documentation-site/patternfly-docs/content/components/calendar-month/calendar-month.md
index cede94bef9..8cc97a9e9b 100644
--- a/packages/documentation-site/patternfly-docs/content/components/calendar-month/calendar-month.md
+++ b/packages/documentation-site/patternfly-docs/content/components/calendar-month/calendar-month.md
@@ -21,5 +21,5 @@ import '../components.css';
6. **Disabled state**
7. **Previous/future date**: Utilizes subtle text colors for days outside of the selected month.
-## Accessibility
+## Accessibility
For information regarding accessibility, visit the [calendar month accessibility](/components/date-and-time/calendar-month/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/card/card.md b/packages/documentation-site/patternfly-docs/content/components/card/card.md
index 8e61eeb99f..6900d6291f 100644
--- a/packages/documentation-site/patternfly-docs/content/components/card/card.md
+++ b/packages/documentation-site/patternfly-docs/content/components/card/card.md
@@ -181,4 +181,4 @@ PatternFly supports three types of cards:
## Accessibility
-For information regarding accessibility, visit the [card accessibility page](/components/card/accessibility).
+For information regarding accessibility, visit the [card accessibility](/components/card/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md b/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
index 6a77aa0dfa..94521e3e50 100644
--- a/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
+++ b/packages/documentation-site/patternfly-docs/content/components/checkbox/checkbox.md
@@ -64,4 +64,4 @@ The main difference between a switch and a checkbox is that a switch changes an
## Accessibility
-For information regarding accessibility, visit the [checkbox accessibility](/components/checkbox/accessibility) tab.
\ No newline at end of file
+For information regarding accessibility, visit the [checkbox accessibility](/components/forms/checkbox/accessibility) tab.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/components/chip/chip.md b/packages/documentation-site/patternfly-docs/content/components/chip/chip.md
index d3cd70cbbb..3a245e09ed 100644
--- a/packages/documentation-site/patternfly-docs/content/components/chip/chip.md
+++ b/packages/documentation-site/patternfly-docs/content/components/chip/chip.md
@@ -26,4 +26,4 @@ Chip groups are useful to express complex filters to a data set, for example.
## Accessibility
-For information regarding accessibility, visit the [chip accessibility](/components/chip/accessibility) tab.
+For information regarding accessibility, visit the [chip accessibility](/components/chip/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/code-editor/code-editor.md b/packages/documentation-site/patternfly-docs/content/components/code-editor/code-editor.md
index ec5b06050e..6a26b77858 100644
--- a/packages/documentation-site/patternfly-docs/content/components/code-editor/code-editor.md
+++ b/packages/documentation-site/patternfly-docs/content/components/code-editor/code-editor.md
@@ -71,5 +71,5 @@ Use the read-only state of the code editor when you only want to display large b
The border of the code editor will turn gray to indicate that it is read-only. The user can still highlight text in the editor, but won’t be able to edit. Adding actions is optional and should be determined by use case.
-## Accessibility
-For information regarding accessibility, visit the [code editor accessibility tab](/components/code-editor/accessibility).
+## Accessibility
+For information regarding accessibility, visit the [code editor accessibility](/components/code-editor/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/expandable-section/expandable-section.md b/packages/documentation-site/patternfly-docs/content/components/expandable-section/expandable-section.md
index 75bce4551d..7aaa821c6e 100644
--- a/packages/documentation-site/patternfly-docs/content/components/expandable-section/expandable-section.md
+++ b/packages/documentation-site/patternfly-docs/content/components/expandable-section/expandable-section.md
@@ -58,6 +58,6 @@ We recommend using dynamic toggle text for an expandable section, which will upd

-## Accessibility
+## Accessibility
-For more information regarding accessibility, visit the [expandable section accessibility tab](/components/expandable-section/accessibility).
+For more information regarding accessibility, visit the [expandable section accessibility](/components/expandable-section/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/helper-text/helper-text.md b/packages/documentation-site/patternfly-docs/content/components/helper-text/helper-text.md
index 96ad4d6729..0bec4835b3 100644
--- a/packages/documentation-site/patternfly-docs/content/components/helper-text/helper-text.md
+++ b/packages/documentation-site/patternfly-docs/content/components/helper-text/helper-text.md
@@ -37,5 +37,5 @@ For information regarding other forms of on-screen help, see [popovers](https://
* Can be written in complete sentences or as a statement
* Use helper text for information critical to a user completing a task, such as password requirements, character requirements, invalid text alerts, etc.
-## Accessibility
-For information regarding accessibility, visit the [helper text accessibility](/components/helper-text/accessibility) tab.
+## Accessibility
+For information regarding accessibility, visit the [helper text accessibility](/components/helper-text/accessibility) tab.
diff --git a/packages/documentation-site/patternfly-docs/content/components/jump-link/jump-link.md b/packages/documentation-site/patternfly-docs/content/components/jump-link/jump-link.md
index a1f8dbb127..dda62afbb3 100644
--- a/packages/documentation-site/patternfly-docs/content/components/jump-link/jump-link.md
+++ b/packages/documentation-site/patternfly-docs/content/components/jump-link/jump-link.md
@@ -71,5 +71,5 @@ We recommended placing jump links on the left side of the content and remaining

-## Accessibility
+## Accessibility
For information regarding accessibility, visit the [jump links accessibility](/components/jump-links/accessibility) tab.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/components/label/label.md b/packages/documentation-site/patternfly-docs/content/components/label/label.md
index f046fc94bd..4dece930af 100644
--- a/packages/documentation-site/patternfly-docs/content/components/label/label.md
+++ b/packages/documentation-site/patternfly-docs/content/components/label/label.md
@@ -258,5 +258,6 @@ When a user selects the **Add label** button, it opens up a modal, where they ca
Once the new label is created, it cannot be edited. Users will need to add a new label if they want to make changes.
+
## Accessibility
-For information regarding accessibility, visit the [labels accessibility](/components/label/accessibility) tab.
\ No newline at end of file
+For information regarding accessibility, visit the [label accessibility](/components/label/accessibility) tab.
\ No newline at end of file
diff --git a/packages/documentation-site/patternfly-docs/content/components/number input/number-input.md b/packages/documentation-site/patternfly-docs/content/components/number input/number-input.md
index fa7bee4220..9b3676ad64 100644
--- a/packages/documentation-site/patternfly-docs/content/components/number input/number-input.md
+++ b/packages/documentation-site/patternfly-docs/content/components/number input/number-input.md
@@ -26,7 +26,7 @@ import '../components.css';
### When not to use
* The numeric value range is infinite.
* The numeric value can be either a fractional or whole number.
-* The numeric value required is not part of a range, or is arbitrary. In this use case, use an input group instead.
+* The numeric value required is not part of a range, or is arbitrary. In this use case, use an [input group](/components/input-group) instead.
* There is not enough space in the UI to account for the interaction between the input field and the buttons.
### Best practices
@@ -34,7 +34,7 @@ import '../components.css';
* Keep labels concise and specific to effectively communicate what value the user should enter into the input field.
* Determine an increment size relative to your specific value range. Scale your increment size to accommodate for the types of values users will input in context.
For example: If your range is from 0-10, have increments of 1, but if your range is from 0-100, have increments of 10.
-* Include unit symbols to the right of the text input and increase button, depending on your use case. Always use a unit’s standard abbreviation or symbol. For a list of recommended symbols, see our Units and symbols page.
+* Include unit symbols to the right of the text input and increase button, depending on your use case. Always use a unit’s standard abbreviation or symbol. For a list of recommended symbols, see our [units and symbols guidance](/content-design/grammar/units-and-symbols).