From 661f6142344cbd77eb6cb3ec07182e4e44eac6f3 Mon Sep 17 00:00:00 2001
From: Sam Potts <sam@potts.es>
Date: Thu, 16 Jul 2026 05:47:47 +1000
Subject: [PATCH] docs(site): update localized label docs (#1820)

---
 site/src/content/docs/reference/play-button.mdx   | 2 +-
 site/src/content/docs/reference/time-slider.mdx   | 2 +-
 site/src/content/docs/reference/volume-slider.mdx | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/site/src/content/docs/reference/play-button.mdx b/site/src/content/docs/reference/play-button.mdx
index 68919946..6fadee5d 100644
--- a/site/src/content/docs/reference/play-button.mdx
+++ b/site/src/content/docs/reference/play-button.mdx
@@ -89,7 +89,7 @@ media-play-button:not([data-started]) .play-icon { display: none; }
 
 ## Accessibility
 
-Renders a `<button>` element with an automatic `aria-label` that updates based on state: "Play", "Pause", or "Replay". Override with the `label` prop (accepts a string or function). Keyboard activation: <kbd>Enter</kbd> / <kbd>Space</kbd>.
+Renders a `<button>` element with an automatic `aria-label` that updates based on state: "Play", "Pause", or "Replay". Override with the `label` prop, which accepts a translation key, custom string, or function returning either. Keyboard activation: <kbd>Enter</kbd> / <kbd>Space</kbd>.
 
 ## Examples
 
diff --git a/site/src/content/docs/reference/time-slider.mdx b/site/src/content/docs/reference/time-slider.mdx
index fbecf350..4ec2b3a2 100644
--- a/site/src/content/docs/reference/time-slider.mdx
+++ b/site/src/content/docs/reference/time-slider.mdx
@@ -83,7 +83,7 @@ media-time-slider[data-seeking] {
 
 ## Accessibility
 
-Renders with `role="slider"` and automatic `aria-label` of "Seek". Override with the `label` prop. Keyboard controls:
+Renders with `role="slider"` and an automatic `aria-label` that resolves to "Seek" from the active locale. Override with the `label` prop. Keyboard controls:
 
 - <kbd>Arrow Left</kbd> / <kbd>Arrow Right</kbd>: step by `step` increment
 - <kbd>Page Up</kbd> / <kbd>Page Down</kbd>: step by `largeStep` increment
diff --git a/site/src/content/docs/reference/volume-slider.mdx b/site/src/content/docs/reference/volume-slider.mdx
index c151264d..0f3825c2 100644
--- a/site/src/content/docs/reference/volume-slider.mdx
+++ b/site/src/content/docs/reference/volume-slider.mdx
@@ -63,7 +63,7 @@ React renders a `<div>` element. Add a `className` to style it:
 
 ## Accessibility
 
-Renders with `role="slider"` and automatic `aria-label` of "Volume". Override with the `label` prop. Keyboard controls:
+Renders with `role="slider"` and an automatic `aria-label` that resolves to "Volume" from the active locale. Override with the `label` prop. Keyboard controls:
 
 - <kbd>Arrow Left</kbd> / <kbd>Arrow Right</kbd>: step by `step` increment
 - <kbd>Page Up</kbd> / <kbd>Page Down</kbd>: step by `largeStep` increment