Skip to content

docs: fix SuspenseList experimental callout - #1684

Open
RaphaelFakhri wants to merge 1 commit into
solidjs:mainfrom
RaphaelFakhri:docs/suspense-list-callout
Open

RaphaelFakhri wants to merge 1 commit into
solidjs:mainfrom
RaphaelFakhri:docs/suspense-list-callout

Conversation

@RaphaelFakhri

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

Description(required)

The <SuspenseList> reference page opens its experimental notice with :::[warning]. That is not a valid container directive (a directive needs a name before the label), so remark-directive leaves it as plain text. The live page at https://docs.solidjs.com/reference/components/suspense-list shows the literal text :::[warning] This is an experimental component ::: instead of a callout.

This PR changes the opener to :::caution, one of the callout types the theme supports (note, tip, advanced, caution, danger) and the type other reference pages use for warnings, such as classlist.mdx and innerhtml.mdx.

To verify, parse every page under src/routes with the same remark plugins Solidbase uses (remark-mdx, remark-frontmatter, remark-gfm, remark-directive) and look for text nodes that start with ::::

  • Before: 272 files checked, 1 failure (suspense-list.mdx:20).
  • After: 272 files checked, 0 failures.

Related issues & labels

  • Closes: none (minor fix)
  • Suggested label(s) (optional): bug

@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 3, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for solid-docs ready!

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

1 participant