USWDS-Site: Documentation updates for 3.12.0

_components/in-page-navigation/in-page-navigation.md

@@ -43,6 +43,9 @@ implementation:
     - property: "`data-threshold`"
       description: Percentage of the scrolling section that must be in the observed area before the current section is triggered. Use a value between 0 and 1.
       default: "1"
+    - property: "`data-minimum-heading-count`"
+      description: The minimum number of headings needed in the content region for the component to build on the page. If the content region does not meet this minimum heading count, the component will not initialize.
+      default: '`2`'
 title: In-page navigation
 type: component
 changelog:

_components/tooltip/guidance/usability.md

@@ -1,4 +1,4 @@
-- **Use affordances.** A hidden tooltip is unusable. Use tooltips only on elements that appear interactive, like buttons or links.
+- **Make tooltips discoverable.** A hidden tooltip is unusable. Use tooltips only on elements that appear interactive, like buttons or links.
 - **Avoid collisions.** Be careful not introduce conflicting hover or focus events.
 - **Use consistently.** If using tooltips in one context, use in all similar contexts.
-- **Don’t block content.** Use the `data-position` attribute to prevent the tooltip from covering other page elements.
+- **Don’t block content.** Use the `data-position` attribute to prevent the tooltip from covering other page elements.

_config.yml

@@ -2,7 +2,7 @@
 title: U.S. Web Design System (USWDS)
 description: USWDS makes it easier to build accessible, mobile-friendly government websites.
 google_analytics_ua: UA-48605964-43
-uswds_version: 3.11.0
+uswds_version: 3.12.0
 uswds_email: [email protected]
 federalist_base: "https://federalist-3b6ba08e-0df4-44c9-ac73-6fc193b0e19c.sites.pages.cloud.gov/preview/uswds/uswds"
 federalist_component_preview: "iframe.html?id="
@@ -44,7 +44,7 @@ jekyll_get:
     json: "https://api.github.com/repos/uswds/uswds/contents/SECURITY.md"
     decode_content: true
   - data: hash
-    json: "https://api.github.com/repos/uswds/uswds/contents/security/uswds-3.11.0-zip-hash.txt?ref=main"
+    json: "https://api.github.com/repos/uswds/uswds/contents/security/uswds-3.12.0-zip-hash.txt?ref=main"
     decode_content: true
 
 repos:

_data/changelogs/component-checkbox.yml

@@ -2,6 +2,13 @@ title: Checkbox
 type: component
 changelogURL:
 items:
+  - date: NNNN-NN-NN
+    summary: Updated the width of the label's target area to match the width of the content.
+    summaryAdditional: Previously, the interactive area extended the full width of the container.
+    affectsStyles: true
+    githubPr: 6192
+    githubRepo: uswds
+    versionUswds: N.N.N
   - date: 2024-11-13
     summary: Removed style tags from indeterminate checkbox SVGs.
     summaryAdditional: |

_data/changelogs/component-date-picker.yml

@@ -2,6 +2,13 @@ title: Date picker
 type: component
 changelogURL:
 items:
+  - date: NNNN-NN-NN
+    summary: Enabled native JavaScript translation for calendar labels.
+    summaryAdditional: The calendar now uses the `Date.toLocaleString` API to automatically build translated labels based on the document's `lang` attribute.
+    affectsJavascript: true
+    githubPr: 5679
+    githubRepo: uswds
+    versionUswds: N.N.N
   - date: 2025-01-14
     summary: Added WCAG compliance tag and accessibility test status section.
     affectsGuidance: true
@@ -14,7 +21,7 @@ items:
     githubRepo: uswds-site
   - date: 2024-10-04
     summary: Fixed a bug that caused `mouseover` events to prevent keyboard navigation.
-    summaryAdditional:  Now when you hover your mouse over the date picker buttons, only the hover state will be triggered.
+    summaryAdditional: Now when you hover your mouse over the date picker buttons, only the hover state will be triggered.
     affectsAccessibility: true
     affectsJavascript: true
     githubPr: 5774

_data/changelogs/component-in-page-navigation.yml

@@ -2,6 +2,21 @@ title: In-page navigation
 type: component
 changelogURL:
 items:
+  - date: NNNN-NN-NN
+    summary: Fixed a bug that prevented in-page navigation from scrolling to nested headings.
+    summaryAdditional: The in-page navigation can now smooth scroll to headings within components like card and summary box.
+    affectsJavascript: true
+    githubRepo: uswds
+    githubPr: 5878
+    versionUswds: N.N.N
+  - date: NNNN-NN-NN
+    summary: Added the `data-minimum-heading-count` property.
+    summaryAdditional: This property hides the component when the content region does not contain the designated minimum number of headings. By default, this property hides the in-page navigation component when there are fewer than two headings in the content region. Teams should customize the value of this property based on their content needs.
+    affectsStyles: true
+    affectsJavascript: true
+    githubPr: 6205
+    githubRepo: uswds
+    versionUswds: N.N.N
   - date: 2024-10-16
     summary: Added WCAG compliance tag and accessibility test status section.
     affectsGuidance: true