Skip to content

[Browser Isolation] ELI5: Clarify jargon and add inline definitions across RBI root pages#29908

Merged
codyanthony850 merged 1 commit into
productionfrom
jun/eli5/rbi-root
Apr 16, 2026
Merged

[Browser Isolation] ELI5: Clarify jargon and add inline definitions across RBI root pages#29908
codyanthony850 merged 1 commit into
productionfrom
jun/eli5/rbi-root

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented Apr 15, 2026

Summary

Adds inline definitions and context for technical terms across all 7 root-level pages in the Remote Browser Isolation section. These pages serve a mixed audience (IT admins, security teams, decision-makers) and used several terms — NVR, WebRTC, rasterization, WebGL, SAML HTTP-POST bindings, DOM access — without explanation.

Changes were generated using the ELI5 skill and verified through an adversarial review that checked every net-new claim against existing documentation.

Key changes by page:

  • index.mdx — Inline definitions for "active webpage content," "zero-day attacks," "Secure Web Gateway," and "Zero Trust Network Access." Broke the dense opening paragraph into two for readability.
  • canvas-rendering.mdx — Defined "HTML5 Canvas API," "rasterized bitmaps," "NVR," "offscreen texture," and "compositing" inline on first use.
  • extensions.mdx — Added context explaining why local extensions cannot interact with isolated pages. Defined "DOM access."
  • isolation-policies.mdx — Added parenthetical for Accept: text/html*. Added introductory sentence to Policy Settings explaining the data-loss-prevention purpose.
  • known-limitations.mdx — Defined NVR, WebGL, H.265/HEVC, Yubikey/WebAuthN, SAML/HTTP-POST bindings inline. Clarified "Browser Isolation does not support HTTP" → "Browser Isolation requires HTTPS." Added WebRTC context to Brave section.
  • network-dependencies.mdx — Defined "remoting client" and "WebRTC" inline. Added explanation that WebRTC uses UDP and does not flow through HTTP proxies.
  • accessibility.mdx — Fixed missing space typo.

Documentation checklist

@github-actions
Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/remote-browser-isolation/ @codyanthony850, @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@Oxyjun Oxyjun self-assigned this Apr 15, 2026
@Oxyjun Oxyjun marked this pull request as ready for review April 15, 2026 16:13
@Oxyjun Oxyjun requested a review from codyanthony850 as a code owner April 15, 2026 16:13
@Oxyjun Oxyjun requested a review from a team April 15, 2026 16:13
@github-actions
Copy link
Copy Markdown
Contributor

Preview URL: https://b210231a.preview.developers.cloudflare.com
Preview Branch URL: https://jun-eli5-rbi-root.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/known-limitations/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/known-limitations/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/canvas-rendering/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/canvas-rendering/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/isolation-policies/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/isolation-policies/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/network-dependencies/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/network-dependencies/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/accessibility/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/accessibility/
https://developers.cloudflare.com/cloudflare-one/remote-browser-isolation/extensions/ https://jun-eli5-rbi-root.preview.developers.cloudflare.com/cloudflare-one/remote-browser-isolation/extensions/

@codyanthony850 codyanthony850 merged commit f49ca90 into production Apr 16, 2026
18 checks passed
@codyanthony850 codyanthony850 deleted the jun/eli5/rbi-root branch April 16, 2026 19:45
nojvek pushed a commit to nojvek/cloudflare-docs that referenced this pull request Apr 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants