Skip to content

docs: catch up with solid rc.22 for stable - #1698

Merged
ryansolid merged 1 commit into
v2-rebuildfrom
claude/project-thread-hswlx6
Nov 16, 2026
Merged

ryansolid merged 1 commit into
v2-rebuildfrom
claude/project-thread-hswlx6

Conversation

@ryansolid

Copy link
Copy Markdown
Member

Requested by Ryan · project thread

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

Description(required)

This PR regenerates the reference and diagnostics pages against solid next 0f6a978, which is rc.22 plus four internal store and signals fixes, and fixes the guides that rc.22 made wrong. Everything documented here shipped in rc.22.

Generator (scripts/extract-solid-ref.mjs)

  • docs: when to use createDeferred instead of latest or createMemo #1693 put the createDeferred caveats inside CANONICAL_ROUTES. That gave createDeferred a second route entry, so sync:ref crashed partway through and deleted create-deferred.mdx. The caveats now live in ENTRY_CAVEATS, and the generated page is byte-identical to the one on the branch.
  • New dispositions: a setTrustedTypesPolicy page (#4833); FlushChange and FlushLive (#4725) folded into attribution; heldRead, isHidden, setSwapHook, verdict, strictReadTracked and strictHandler hidden. All six are tagged @internal upstream, but the scan does not see a tag on an export { … } from statement.
  • The portal page's link to the ref pitfall follows its new heading.

Regenerated reference

  • New page setTrustedTypesPolicy.
  • onFlush: each callback now runs in its own flush (#4764). The page used to say the callbacks batch into one flush.
  • DEV.setSignal (#4688), the new FlushEvent.changes and the slimmer observe hooks (#4725), and lowPriorityPreloads on renderToString and renderToStream (#4512). The renderToStream page also covers what happens when its signal aborts.

Diagnostics

  • New pages: CAUGHT_REACTIVE_READ and OPTIMISTIC_WRITE_BEFORE_LOAD, which were already missing before rc.21, plus INVALID_HTML_NESTING, OPTIMISTIC_WRITE_WHILE_LOADING and STORE_WRITE_THROUGH_LOADING.
  • STRICT_READ_UNTRACKED now covers event handler expressions (#4838). CLEANUP_IN_FORBIDDEN_SCOPE, PRIMITIVE_IN_EFFECT_CALLBACK and the index page are updated too.

Guides

  • Ref callbacks (#4768): a ref now runs untracked in the pass that creates the element, and it owns nothing. In dev, creating an effect there or calling onCleanup throws. Before, the docs said refs run with no owner and that an effect inside one "never runs". Updated in concepts/components-and-jsx (including the pitfall heading), guides/integrate-non-solid-code and the ref reference.
  • From React: the onClick={ready() ? save : wait} row now points at STRICT_READ_UNTRACKED.
  • Rendering and SSR: a new common-problems entry for the TrustedHTML assignment error, showing how to use setTrustedTypesPolicy.

Checks: check:types, check:lint, prettier --check, lint:tone (0 errors; one existing warning on action.mdx) and pnpm build all pass. I did not run check:examples, because it needs built local checkouts. Upstream nit, not fixed here: the onFlush JSDoc still contains "Don't", which breaks the no-contractions rule.

Still not covered on the solid side: the repair skill has a FLUSH_IN_ACTION section but no diagnostics.json entry for it, so it gets no page.

Related issues & labels

  • Suggested label(s) (optional): documentation

Generated by Claude Code

Regenerates the reference and diagnostics pages against solid next
0f6a978 (rc.22 plus four internal fixes) and fixes guides that rc.22
made wrong.

- Generator: move the createDeferred caveats from CANONICAL_ROUTES to
  ENTRY_CAVEATS (#1693 put them in the route map, which broke
  sync:ref); add setTrustedTypesPolicy as a page, fold FlushChange and
  FlushLive into attribution, hide six @internal re-exports.
- New pages: setTrustedTypesPolicy, and diagnostics CAUGHT_REACTIVE_READ,
  INVALID_HTML_NESTING, OPTIMISTIC_WRITE_BEFORE_LOAD,
  OPTIMISTIC_WRITE_WHILE_LOADING, STORE_WRITE_THROUGH_LOADING.
- onFlush: each callback runs in its own flush (#4764).
- Ref callbacks run in the creating pass and own nothing; an effect or
  onCleanup there throws in dev (#4768).
- From React: handler expressions warn STRICT_READ_UNTRACKED (#4838).
- Rendering and SSR: a common-problem entry for Trusted Types.

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

Copy link
Copy Markdown

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

@ryansolid ryansolid self-assigned this Nov 16, 2026
@netlify

netlify Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for solid-docs-v2 ready!

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

@ryansolid
ryansolid merged commit d4fb338 into v2-rebuild Nov 16, 2026
8 checks passed
@ryansolid
ryansolid deleted the claude/project-thread-hswlx6 branch November 16, 2026 07:06
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