docs: improve intro of a11y guide

[decepulis]

• reword first sentence to reflect aspirational framing. (Accessibility is never done!)
• add additional section to make clear this is not just a feature list, but also an intro for customizers

---

Note

Low Risk
Low risk documentation-only update that adjusts framing and metadata without affecting runtime behavior.

Overview
Updates the Accessibility concept doc intro to use more aspirational language and explicitly position the page as guidance for teams doing deep player customization.

Also revises the page description frontmatter to match the new framing.

^{Reviewed by Cursor Bugbot for commit 58032e0. Bugbot is set up for automated code reviews on this repo. Configure here.}

[netlify]

✅ Deploy Preview for vjs10-site ready!

Name	Link
🔨 Latest commit	58032e0
🔍 Latest deploy log	https://app.netlify.com/projects/vjs10-site/deploys/69dd38e9943d630007850055
😎 Deploy Preview	https://deploy-preview-1318--vjs10-site.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
v10-sandbox	Ready	Preview, Comment	Apr 13, 2026 6:41pm

[github-actions]

📦 Bundle Size Report

🎨 @videojs/html — no changes

Presets (7)

Entry	Size
/video (default)	27.59 kB
/video (default + hls)	159.84 kB
/video (minimal)	25.12 kB
/video (minimal + hls)	157.47 kB
/audio (default)	25.59 kB
/audio (minimal)	23.22 kB
/background	4.16 kB

Media (8)

Entry	Size
/media/background-video	1.04 kB
/media/container	1.73 kB
/media/dash-video	236.51 kB
/media/hls-video	133.61 kB
/media/mux-audio	156.15 kB
/media/mux-video	156.10 kB
/media/native-hls-video	3.62 kB
/media/simple-hls-video	15.87 kB

Players (3)

Entry	Size
/video/player	6.49 kB
/audio/player	4.90 kB
/background/player	3.86 kB

Skins (17)

Entry	Type	Size
/video/minimal-skin.css	css	3.47 kB
/video/skin.css	css	3.49 kB
/video/minimal-skin	js	25.12 kB
/video/minimal-skin.tailwind	js	25.33 kB
/video/skin	js	27.56 kB
/video/skin.tailwind	js	27.71 kB
/audio/minimal-skin.css	css	2.53 kB
/audio/skin.css	css	2.50 kB
/audio/minimal-skin	js	23.27 kB
/audio/minimal-skin.tailwind	js	23.37 kB
/audio/skin	js	25.57 kB
/audio/skin.tailwind	js	25.71 kB
/background/skin.css	css	117 B
/background/skin	js	1.15 kB
/base.css	css	157 B
/shared.css	css	88 B
/skin-element	js	1.35 kB

UI Components (24)

Entry	Size
/ui/alert-dialog	1015 B
/ui/alert-dialog-close	470 B
/ui/alert-dialog-description	371 B
/ui/alert-dialog-title	389 B
/ui/buffering-indicator	2.02 kB
/ui/captions-button	2.21 kB
/ui/compounds	2.56 kB
/ui/controls	1.44 kB
/ui/error-dialog	2.48 kB
/ui/fullscreen-button	2.30 kB
/ui/hotkey	2.28 kB
/ui/mute-button	2.28 kB
/ui/pip-button	2.23 kB
/ui/play-button	2.27 kB
/ui/playback-rate-button	2.07 kB
/ui/popover	1.84 kB
/ui/poster	1.82 kB
/ui/seek-button	2.27 kB
/ui/slider	1.53 kB
/ui/thumbnail	2.48 kB
/ui/time	1.54 kB
/ui/time-slider	2.62 kB
/ui/tooltip	2.02 kB
/ui/volume-slider	2.23 kB

Sizes are marginal over the root entry point.

⚛️ @videojs/react — no changes

Presets (7)

Entry	Size
/video (default)	22.33 kB
/video (default + hls)	154.76 kB
/video (minimal)	20.02 kB
/video (minimal + hls)	152.56 kB
/audio (default)	18.33 kB
/audio (minimal)	16.83 kB
/background	754 B

Media (7)

Entry	Size
/media/background-video	575 B
/media/dash-video	236.42 kB
/media/hls-video	133.55 kB
/media/mux-audio	156.30 kB
/media/mux-video	156.16 kB
/media/native-hls-video	3.65 kB
/media/simple-hls-video	15.92 kB

Skins (14)

Entry	Type	Size
/video/minimal-skin.css	css	3.40 kB
/video/skin.css	css	3.42 kB
/video/minimal-skin	js	19.96 kB
/video/minimal-skin.tailwind	js	23.42 kB
/video/skin	js	22.26 kB
/video/skin.tailwind	js	23.48 kB
/audio/minimal-skin.css	css	2.43 kB
/audio/skin.css	css	2.39 kB
/audio/minimal-skin	js	16.74 kB
/audio/minimal-skin.tailwind	js	19.24 kB
/audio/skin	js	18.23 kB
/audio/skin.tailwind	js	19.23 kB
/background/skin.css	css	90 B
/background/skin	js	272 B

UI Components (19)

Entry	Size
/ui/alert-dialog	1.13 kB
/ui/buffering-indicator	1.71 kB
/ui/captions-button	2.23 kB
/ui/controls	1.69 kB
/ui/error-dialog	1.62 kB
/ui/fullscreen-button	2.21 kB
/ui/mute-button	2.22 kB
/ui/pip-button	2.26 kB
/ui/play-button	2.24 kB
/ui/playback-rate-button	1.90 kB
/ui/popover	1.89 kB
/ui/poster	1.53 kB
/ui/seek-button	2.25 kB
/ui/slider	3.03 kB
/ui/thumbnail	2.04 kB
/ui/time	1.83 kB
/ui/time-slider	2.77 kB
/ui/tooltip	2.28 kB
/ui/volume-slider	2.75 kB

Sizes are marginal over the root entry point.

🧩 @videojs/core — no changes

Entries (8)

Entry	Size
.	5.29 kB
/dom	11.38 kB
/dom/media/custom-media-element	1.91 kB
/dom/media/dash	235.94 kB
/dom/media/hls	132.95 kB
/dom/media/mux	155.73 kB
/dom/media/native-hls	2.97 kB
/dom/media/simple-hls	15.31 kB

🏷️ @videojs/element — no changes

Entries (2)

Entry	Size
.	999 B
/context	943 B

📦 @videojs/store — no changes

Entries (3)

Entry	Size
.	1.38 kB
/html	696 B
/react	360 B

🔧 @videojs/utils — no changes

Entries (10)

Entry	Size
/array	104 B
/dom	1.80 kB
/events	319 B
/function	327 B
/object	247 B
/predicate	265 B
/string	148 B
/style	190 B
/time	478 B
/number	158 B

📦 @videojs/spf — no changes

Entries (3)

Entry	Size
.	40 B
/dom	13.27 kB
/playback-engine	13.11 kB

---

ℹ️ How to interpret

All sizes are standalone totals (minified + brotli).

Icon	Meaning
✅	No change
🔺	Increased ≤ 10%
🔴	Increased > 10%
🔽	Decreased
🆕	New (no baseline)

Run pnpm size locally to check current sizes.