Skip to content

docs: fix stale spec anchor "The transparent proxy" → "Iframe Renderer"#161

Merged
nedtwigg merged 1 commit into
mainfrom
fix/spec-anchor-iframe-renderer
Jun 20, 2026
Merged

docs: fix stale spec anchor "The transparent proxy" → "Iframe Renderer"#161
nedtwigg merged 1 commit into
mainfrom
fix/spec-anchor-iframe-renderer

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

Fix stale spec anchor: "The transparent proxy" → "Iframe Renderer"

Two source-comment doc-pointers reference a docs/specs/dor-browser.md section that does not exist:

  • lib/src/lib/platform/types.ts:179// iframe surface support (see docs/specs/dor-browser.md → "The transparent proxy")
  • vscode-ext/src/iframe-proxy-host.ts:5* ... see docs/specs/dor-browser.md → "The transparent proxy"

When the iframe and agent-browser specs were unified into dor-browser.md (#156), the proxy ended up documented under the "Iframe Renderer" section (docs/specs/dor-browser.md line 302). There is no "The transparent proxy" heading anywhere in the file, so both anchors dangle. Commit 595531c ("specs: fix code doc-pointer anchors") swept most of these but missed these two — they're the only anchors that wrap the section title across two comment lines, so a single-line grep didn't catch them.

The sibling pointers for the very same proxy code already point at the right section:

  • lib/src/host/iframe-proxy.ts:3"Iframe Renderer"
  • lib/src/host/iframe-proxy-rewrite.ts:3"Iframe Renderer"
  • lib/src/lib/platform/iframe-proxy-types.ts:3"Iframe Renderer"

This PR updates the two stragglers to match.

Comment-only change — no behavior change, so no test is added. Verified by grep that no → "The transparent proxy" anchor remains in lib/, vscode-ext/, or standalone/ (the lone remaining "transparent proxy" mention is descriptive prose, not a section anchor).

Two doc-pointer comments reference a dor-browser.md section that does not
exist. When dor-iframe.md + dor-agent-browser.md were unified into
dor-browser.md (#156), the proxy moved under the "Iframe Renderer" section;
the cleanup in 595531c missed these two because they wrap the section title
across two comment lines. Match the sibling pointers in iframe-proxy.ts,
iframe-proxy-rewrite.ts, and iframe-proxy-types.ts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 20, 2026

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5682cd7
Status: ✅  Deploy successful!
Preview URL: https://b7a46c3f.mouseterm.pages.dev
Branch Preview URL: https://fix-spec-anchor-iframe-rende.mouseterm.pages.dev

View logs

@nedtwigg nedtwigg merged commit 64ea38d into main Jun 20, 2026
7 checks passed
@nedtwigg nedtwigg deleted the fix/spec-anchor-iframe-renderer branch June 20, 2026 14:27
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.

2 participants