Skip to content

Docs: consolidate accessibility documentation under License, Pricing and Compliance#9238

Merged
JonnyBurger merged 8 commits into
mainfrom
docs/9235-consolidate-accessibility-docs
Jul 20, 2026
Merged

Docs: consolidate accessibility documentation under License, Pricing and Compliance#9238
JonnyBurger merged 8 commits into
mainfrom
docs/9235-consolidate-accessibility-docs

Conversation

@MehmetAdemi

@MehmetAdemi MehmetAdemi commented Jul 18, 2026

Copy link
Copy Markdown
Member

Summary

Closes #9235.

Consolidates all accessibility documentation under License, Pricing and Compliance so it is discoverable from one place, while keeping product accessibility and website conformance statements clearly separated.

License, Pricing and Compliance
└── Accessibility                          → /docs/accessibility (unchanged URL)
    ├── Accessibility Statement: remotion.dev
    └── Accessibility Statement: remotion.pro
  • Moved /docs/accessibility from the Miscellaneous sidebar section into a new nested "Accessibility" category under License, Pricing and Compliance. The URL is unchanged; only the sidebar crumb/label were updated to make clear this page is a product accessibility overview, not a website conformance statement.
  • Added /docs/license/accessibility-statement-remotion-dev, a new accessibility conformance statement scoped to the remotion.dev website, based on the existing internal VPAT 2.4 Rev and RGAA 4.1.2 audit materials (packages/compliance/a11y/remotion.dev). Decided not to publish the VPAT/audit report as a downloadable file for now — it's available on request.
  • Added /docs/license/accessibility-statement-remotion-pro, scoped specifically to remotion.pro and presented as a snapshot based on its most recently executed VPAT. VPAT links use absolute remotion.pro URLs. It is written to become the remotion.dev source of truth when the planned remotion.pro accessibility redirect is introduced; that redirect is not part of this PR. pro/src/accessibility.md itself was not modified.
  • Added an "Accessibility" card to the License, Pricing and Compliance overview page (docs/license/TableOfContents.tsx).
  • Reconciled the Player and Studio sections on /docs/accessibility with the current internal VPAT findings (packages/compliance/a11y/player, packages/compliance/a11y/studio) — the previous copy claimed the Player "meets modern accessibility standards" and Studio was "doing well", which contradicts several "Does Not Support" findings (e.g. the Player's seek bar/volume slider are not keyboard-operable; Studio's search and "Render via CLI" dialogs don't trap focus). The page now states these gaps explicitly instead of overclaiming.

Out of scope (per issue)

  • No runtime/build-time/CI sync mechanism between this repo and pro.
  • No changes to pro/src/accessibility.md.
  • The existing remotion.pro accessibility page is not removed or redirected.

Test plan

  • bun x tsc --noEmit shows no new errors introduced by this change (same pre-existing, unrelated errors present on main).
  • bun x prettier --check docs/license/accessibility-statement-remotion-dev.mdx docs/license/accessibility-statement-remotion-pro.mdx
  • No linter errors on edited/added files.
  • Manually reviewed sidebars.ts for correct nested category structure (Accessibility category with link.id: accessibility nested inside License, Pricing and Compliance).
  • Confirmed /docs/accessibility keeps its existing route (routes.redirect('/accessibility', '/docs/accessibility', ...) in vercel.ts untouched) and that no doc ids were renamed.
  • Confirmed pro/src/accessibility.md is untouched.
  • Reviewer: run bun render-cards.ts in packages/docs to generate the OG preview images for the two new pages (blocked locally by an unrelated pre-existing build issue with @remotion/effects/skew in this environment).

…and Compliance

Move the product accessibility overview into a nested "Accessibility"
sidebar category under License, Pricing and Compliance, and add
website-specific accessibility statements for remotion.dev and
remotion.pro so that all accessibility documentation is discoverable
from one place.

- Move /docs/accessibility into the License, Pricing and Compliance
  category (URL unchanged) and update its crumb/label to make clear
  it documents product accessibility, not website conformance.
- Add /docs/license/accessibility-statement-remotion-dev, based on
  the existing remotion.dev VPAT and RGAA audit materials.
- Add /docs/license/accessibility-statement-remotion-pro as a
  one-time copy of pro/src/accessibility.md, with relative links
  rewritten to absolute remotion.pro URLs. pro/src/accessibility.md
  is left untouched.
- Add an Accessibility card to the License, Pricing and Compliance
  overview page.
- Reconcile the Player and Studio accessibility claims on the
  product overview page with the current VPAT findings.

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
bugs Ready Ready Preview, Comment Jul 19, 2026 10:58am
remotion Ready Ready Preview, Comment Jul 19, 2026 10:58am

Request Review

Place acknowledgements within the License, Pricing and Compliance section and remove the dated-copy note from the remotion.pro accessibility statement.

Co-authored-by: Cursor <cursoragent@cursor.com>
Scope the remotion.pro statement to its latest VPAT snapshot and make the remotion.dev product references and current limitations more precise.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep product references within the documentation site instead of routing readers through absolute URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Use descriptive local product links and link the remotion.pro website from its accessibility statement.

Co-authored-by: Cursor <cursoragent@cursor.com>

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[!IMPORTANT] Missing generated social-card images. The two new accessibility statement pages reference articles-docs-license-accessibility-statement-remotion-dev.png and ...remotion-pro.png in packages/docs/static/generated/, but these files are not committed. Please run bun run render-cards.ts in packages/docs and commit the assets before merging.

Pullfrog  | Fix all ➔Fix 👍s ➔View workflow run | Using Kimi K2 (free via Pullfrog for OSS) | 𝕏

Comment thread packages/docs/docs/license/accessibility-statement-remotion-dev.mdx
Comment thread packages/docs/docs/license/accessibility-statement-remotion-pro.mdx
Comment thread packages/docs/docs/license/TableOfContents.tsx Outdated
Comment thread packages/docs/sidebars.ts
@MehmetAdemi
MehmetAdemi requested a review from JonnyBurger July 19, 2026 10:52
@JonnyBurger JonnyBurger changed the title docs: consolidate accessibility documentation under License, Pricing and Compliance Docs: consolidate accessibility documentation under License, Pricing and Compliance Jul 20, 2026
@JonnyBurger
JonnyBurger merged commit 9478b2f into main Jul 20, 2026
16 checks passed
@JonnyBurger
JonnyBurger deleted the docs/9235-consolidate-accessibility-docs branch July 20, 2026 07:45
pull Bot pushed a commit to himyjan/remotion that referenced this pull request Jul 20, 2026
The statement referenced "VPAT 2.5Rev", but the actual document
(docs/a11y/records/VPAT.md in the pro repo) and the PDF metadata
emitted by scripts/generate-vpat-pdf.mjs both say "VPAT 2.4 Rev".
The "2.5Rev" label was introduced in remotion-dev#9238 when the statement was
consolidated under License, Pricing and Compliance and is a typo,
not a version bump. Align the docs page with the real document.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: consolidate accessibility documentation under License, Pricing and Compliance

2 participants