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

@Oxyjun Oxyjun commented Apr 15, 2026

Copy link
Copy Markdown
Contributor

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
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