Skip to content

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

Draft
ryansolid wants to merge 1 commit into
v2-rebuildfrom
claude/docs-domain-switch
Draft

ryansolid wants to merge 1 commit into
v2-rebuildfrom
claude/docs-domain-switch

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)

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. That makes the site treat 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 a change, Google would drop docs.solidjs.com from its index.

This PR changes netlify.toml only:

  • [context.production.environment] SITE_URL = "https://docs.solidjs.com". Production builds write no 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/* 301s to the same path on docs.solidjs.com. Dev warnings in solid (diagnostics links), JSDoc @description links and the AI tools page all point at v2.solidjs.com, so those links keep working and land on the canonical page. Their text can move to docs.solidjs.com later.

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

Related issues & labels

  • Suggested label(s) (optional): documentation

Generated by Claude Code

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 37901a4
🔍 Latest deploy log https://app.netlify.com/projects/solid-docs-v2/deploys/6afaacf5e3e814e9e02f0be1
😎 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.

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