Kliao/browser rendering terminology rename#29670
Merged
kathayl merged 18 commits intoproductionfrom Apr 10, 2026
Merged
Conversation
…erminology - Rename 'REST API' to 'Quick Actions' across all current BR docs - Move workers-bindings content to how-to/ and features/ - Delete workers-bindings/index.mdx navigation page - Update URL paths /rest-api/ -> /quick-actions/ everywhere - Use 'Browser Sessions' as billing category for Puppeteer/Playwright/CDP - Keep 'browser automation' as descriptive term in natural prose - Update pricing/limits to clarify Quick Actions vs Browser Sessions billing - Historical changelogs/release notes: URL paths only, preserve display text - Fix chained redirects to point directly to final destinations - Add redirects for all old /rest-api/ and /workers-bindings/ paths
…ons, clarify disconnect vs DO approaches
kathayl
commented
Apr 7, 2026
Contributor
|
This PR requires additional review attention because it affects the following areas: RedirectsThis PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:
PartialsThis PR updates partial files, which are pieces of content used across multiple files in our Render component.
|
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
Contributor
nitpick - since puppeteer + playwright use CDP
kathayl
requested review from
a team,
ToriLindsay,
celso and
mchenco
as code owners
- Replace /browser-rendering/workers-bindings/ with /browser-rendering/#integration-methods in release notes, changelogs - Update link in workers websocket changelog to point to /browser-rendering/ - Fixes starlight-links-validator CI failure
kathayl
force-pushed
the
kliao/browser-rendering-terminology-rename
branch
from
7a94709 to
59615c0
Compare
- Rename 'Puppeteer and Playwright' section to 'Browser sessions' to cover all browser session methods - Update intro bullets to include CDP alongside Puppeteer and Playwright - Add explanatory note that examples use Workers Bindings but CDP works the same way - Add CDP connection example subsection showing puppeteer.connect() with WebSocket endpoint
…arkdown-conversion page
kathayl
requested review from
craigsdennis,
rita3ko and
superhighfives
as code owners
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
reviewed
Apr 10, 2026
pedrosousa
approved these changes
Apr 10, 2026
Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
nojvek
pushed a commit
to nojvek/cloudflare-docs
that referenced
this pull request
Apr 29, 2026
* Rename REST API -> Quick Actions, dissolve Workers Bindings, update terminology - Rename 'REST API' to 'Quick Actions' across all current BR docs - Move workers-bindings content to how-to/ and features/ - Delete workers-bindings/index.mdx navigation page - Update URL paths /rest-api/ -> /quick-actions/ everywhere - Use 'Browser Sessions' as billing category for Puppeteer/Playwright/CDP - Keep 'browser automation' as descriptive term in natural prose - Update pricing/limits to clarify Quick Actions vs Browser Sessions billing - Historical changelogs/release notes: URL paths only, preserve display text - Fix chained redirects to point directly to final destinations - Add redirects for all old /rest-api/ and /workers-bindings/ paths * Reframe integration methods with Quick Actions vs Browser Sessions overview * Rewrite reuse-sessions intro: explain feature, scope to Browser Sessions, clarify disconnect vs DO approaches * Update automatic-request-headers.mdx nitpick - since puppeteer + playwright use CDP * Fix broken internal links to deleted workers-bindings page - Replace /browser-rendering/workers-bindings/ with /browser-rendering/#integration-methods in release notes, changelogs - Update link in workers websocket changelog to point to /browser-rendering/ - Fixes starlight-links-validator CI failure * Add CDP instructions to custom fonts, rename section to Browser sessions - Rename 'Puppeteer and Playwright' section to 'Browser sessions' to cover all browser session methods - Update intro bullets to include CDP alongside Puppeteer and Playwright - Add explanatory note that examples use Workers Bindings but CDP works the same way - Add CDP connection example subsection showing puppeteer.connect() with WebSocket endpoint * Fix broken link: update /rest-api/ to /quick-actions/ in workers-ai markdown-conversion page * Switch dynamic redirects for single files into static redirects * Create new paragraph (add new line) * Add space * Reorganize imports * Switch to relative URL path in release note * Small update * Small fixes and updates * Update src/content/docs/browser-rendering/features/custom-fonts.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> * Update src/content/docs/browser-rendering/how-to/pdf-generation.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --------- Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The original names ("REST API" and "Workers Bindings") no longer work:
New feature- CDP breaks the naming model. CDP connects via a REST API endpoint but is billed like Workers Bindings (browser hours + concurrency). The old names conflated the access method with the billing model, making it unclear where CDP fits.
New feature -Quick Actions are coming to Workers Bindings. Screenshot, PDF, markdown, and other actions currently available only through the REST API will soon be callable through a binding too. Calling them "REST API" no longer works when the same actions are available through multiple access methods.
Note- "Workers Bindings" is an implementation detail. Users think in terms of Puppeteer, Playwright, or CDP, not "bindings." The section has been dissolved and its content moved to
how-to/andfeatures/where users would naturally look.The new terminology separates what you can do from how you're charged:
Changes
Renames:
/rest-api/→/quick-actions/(URL paths)Reorganization:
workers-bindings/reuse-sessions.mdx→ features/reuse-sessions.mdxworkers-bindings/screenshots.mdx→how-to/deploy-worker.mdxworkers-bindings/browser-rendering-with-DO.mdx→how-to/browser-rendering-with-do.mdxworkers-bindings/index.mdxnavigation pageTerminology:
Pricing/limits clarity:
Historical docs:
Redirects:
/rest-api/*→/quick-actions/*/workers-bindings/*→ appropriate new locations