Skip to content

docs: when to use createDeferred instead of latest or createMemo - #1693

Open
ryansolid wants to merge 1 commit into
v2-rebuildfrom
claude/project-thread-c5xes4-4773
Open

ryansolid wants to merge 1 commit into
v2-rebuildfrom
claude/project-thread-c5xes4-4773

Conversation

@ryansolid

Copy link
Copy Markdown
Member
  • I have read the Contribution guide
  • This PR references an issue (except for typos, broken links, or other minor problems)

Description(required)

solidjs/solid#4773 asks when to reach for createDeferred, and suggests it is the same as reading every consumer through latest. It is not: latest changes what one reader shows while the update stays held for every other reader, whereas a deferred memo is not part of the update at all, so nothing waits for it.

  • Async reactivity concept page: a new "Let a panel lag: createDeferred" section after the latest one, using the page's own dashboard (the ten-second audit panel). It contrasts reader-side latest with source-side createDeferred, says when to use each, and notes that a deferred memo lags but never leads (its first load still suspends; a refetch that reads a held value lands with that hold). The update decision table gains a fourth row pointing to it.
  • createDeferred reference: a Caveats section with the same distinction. It is added to ENTRY_CAVEATS in scripts/extract-solid-ref.mjs and written into the generated page by hand. A full sync:ref run against current next stops on an unrelated new export (verdict) that has no disposition yet.

The semantics follow Solid's ruling for deferred sources (D-40: a deferred source lags its readers and never leads them).

Related issues & labels


Generated by Claude Code

Adds a "Let a panel lag" section to the async reactivity concept page, a
row for it in the update decision table, and caveats on the reference page
contrasting it with reading every consumer through latest (solidjs/solid#4773).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0117BoWNSSgtemsSYsaX2hXE
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@netlify

netlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for solid-docs-v2 ready!

Name Link
🔨 Latest commit f432ec8
🔍 Latest deploy log https://app.netlify.com/projects/solid-docs-v2/deploys/6af4e7199f9769245793e899
😎 Deploy Preview https://deploy-preview-1693--solid-docs-v2.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.

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