Skip to content

docs: trim never-landed churn from the 0.9 migration guide - #199

Merged
antfu merged 1 commit into
mainfrom
docs/migration-0.9-cleanup
Aug 13, 2026
Merged

docs: trim never-landed churn from the 0.9 migration guide#199
antfu merged 1 commit into
mainfrom
docs/migration-0.9-cleanup

Conversation

@antfubot

Copy link
Copy Markdown
Collaborator

What

Reviews docs/guide/migration-0.9.md against the actual code delta from the v0.8.2 release commit to current main, and trims migration steps that never net-landed for a 0.8.2 user.

Why

Six sections documented before/after churn on initDevframe/initHub, @devframes/hub-ui, and the client renderer registry. Every one of those APIs was introduced and reshaped entirely within the unreleased 0.9 line — none existed at v0.8.2 — so their "0.8.x → 0.9" tables described transitions a real upgrader never experiences. A 0.8.x → 0.9 guide should only cover deltas an actual 0.8.2 user hits; the new-feature detail belongs in the feature docs.

Changes

  • Remove the six never-landed sections: the two WebSocket-binding/register sections, the key-option section, the Bun-tier section, renderers.mount() typed result, and the hub-ui json-render-registry section.
  • Correct the devframe/internal move table: createContextRpcServer is new in 0.9, not moved off devframe/node, so drop that row; fix the dangling reference to the removed register section.
  • Lead the page with an at-a-glance Overview of the eleven genuine deltas, grouped by devframe and @devframes/hub.
  • Minor tidy: fix a scrambled import block and one historically-inaccurate phrase.

Net: 27 insertions, 112 deletions. The eleven retained sections were each verified as public at v0.8.2 and removed/moved at HEAD.

This PR was created with the help of an agent.

… overview

The 0.8.x→0.9 guide documented six sections of before/after churn on
initDevframe/initHub, hub-ui, and the client renderer registry — all APIs
introduced within the unreleased 0.9 line and absent at v0.8.2, so their
migration framing described changes that never net-landed for a 0.8.2 user.
Drop those sections, correct the devframe/internal move table (createContextRpcServer
is new, not moved), and lead the page with an at-a-glance overview of the
genuine deltas grouped by package.
@netlify

netlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Deploy Preview for devfra ready!

Name Link
🔨 Latest commit f526013
🔍 Latest deploy log https://app.netlify.com/projects/devfra/deploys/6a7d76698eb41000083b4bd9
😎 Deploy Preview https://deploy-preview-199--devfra.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@antfu
antfu merged commit 0d36714 into main Aug 13, 2026
12 checks passed
@antfu
antfu deleted the docs/migration-0.9-cleanup branch August 13, 2026 07:56
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