Skip to content

build: serve the 2.0 docs as docs.solidjs.com - #1699

Merged
ryansolid merged 4 commits into
v2-rebuildfrom
claude/docs-domain-switch
Nov 16, 2026
Merged

ryansolid merged 4 commits into
v2-rebuildfrom
claude/docs-domain-switch

Conversation

@ryansolid

@ryansolid ryansolid commented Nov 16, 2026 •

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)

Merge only once docs.solidjs.com points at this Netlify site. Until then, the redirect would send v2.solidjs.com visitors to the 1.x docs.

When SITE_URL is unset, the build falls back to DEPLOY_PRIME_URL. The site then treats itself as non-canonical: every page gets X-Robots-Tag: noindex, and the sitemap and llms files use the Netlify host. If docs.solidjs.com became an alias of this site without this change, Google would drop docs.solidjs.com from its index.

netlify.toml

  • [context.production.environment] SITE_URL = "https://docs.solidjs.com". Production builds no longer write the noindex header, and their sitemap, llms.txt, llms-full.txt and llms-small.txt use docs.solidjs.com URLs. Deploy previews keep their own URL and the noindex header.
  • https://v2.solidjs.com/* redirects (301) to the same path on docs.solidjs.com. Solid's dev warnings (diagnostics links) and JSDoc @description links point at v2.solidjs.com, so those links keep working and land on the canonical page.

Agent-facing text

  • The AI tools page, the llms-small primer, and the sample diagnostic in the diagnostics index (and its generator, scripts/extract-diagnostics.mjs) now name docs.solidjs.com.
  • The generated dev.mdx still shows v2.solidjs.com, because it comes from solid's JSDoc. It updates with the next sync:ref after solid's links move.

Still to do at the switch: the Overview note links the 1.x docs at docs.solidjs.com. It needs the 1.x site's new address, which has not been decided yet.

Checked: SITE_URL=https://docs.solidjs.com pnpm build writes no _headers file, and all llms.txt links and sitemap <loc>s use docs.solidjs.com. prettier --check passes.

Related issues & labels

  • Suggested label(s) (optional): documentation

🤖 Generated with Claude Code

https://claude.ai/code/session_0117BoWNxvzLd4SQ3p3kgdA1

Production builds set SITE_URL to https://docs.solidjs.com, so the
sitemap and llms files use it and the noindex header for non-canonical
hosts is not written. v2.solidjs.com 301s to the same path on
docs.solidjs.com. Merge only once docs.solidjs.com points at this site.

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 a49d09e
🔍 Latest deploy log https://app.netlify.com/projects/solid-docs-v2/deploys/6afb74cea9b87d228119b210
😎 Deploy Preview https://deploy-preview-1699--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.

The AI tools page, the llms-small primer and the sample diagnostic in the
diagnostics index name docs.solidjs.com, the host they will be served
from once this PR lands. v2.solidjs.com redirects there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0117BoWNxvzLd4SQ3p3kgdA1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0117BoWNxvzLd4SQ3p3kgdA1
@ryansolid
ryansolid marked this pull request as ready for review November 16, 2026 21:25
@ryansolid
ryansolid merged commit 45e611c into v2-rebuild Nov 16, 2026
8 checks passed
@ryansolid
ryansolid deleted the claude/docs-domain-switch branch November 16, 2026 21:29
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