From 093f36808c169288dc508a10a75bf0e29ef27bfa Mon Sep 17 00:00:00 2001 From: Brenley Dueck Date: Mon, 16 Nov 2026 15:42:06 -0600 Subject: [PATCH 1/2] docs: send Solid 1 links and old v1 paths to v1.solidjs.com docs.solidjs.com now serves the 2.0 docs, so Solid 1 URLs on it return 404. --- .github/ISSUE_TEMPLATE/BUGS.yml | 2 +- .github/ISSUE_TEMPLATE/CONTENT.yml | 2 +- .github/ISSUE_TEMPLATE/REQUEST.yml | 2 +- PROPOSAL-solid-2.0-docs.md | 8 +- netlify.toml | 161 ++++++++++++++++++ .../(6)migration/(2)from-solid-start.mdx | 4 +- 6 files changed, 170 insertions(+), 9 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/BUGS.yml b/.github/ISSUE_TEMPLATE/BUGS.yml index 18358ff125..961dbe4b53 100644 --- a/.github/ISSUE_TEMPLATE/BUGS.yml +++ b/.github/ISSUE_TEMPLATE/BUGS.yml @@ -20,7 +20,7 @@ body: attributes: label: "📋 On which page(s) it occurs" description: Please indicate on which page(s) the issue occurs. - placeholder: https://docs.solidjs.com/concepts/intro-to-reactivity + placeholder: https://docs.solidjs.com/concepts/reactivity validations: required: true - type: textarea diff --git a/.github/ISSUE_TEMPLATE/CONTENT.yml b/.github/ISSUE_TEMPLATE/CONTENT.yml index 1b1ebe748d..f453f16290 100644 --- a/.github/ISSUE_TEMPLATE/CONTENT.yml +++ b/.github/ISSUE_TEMPLATE/CONTENT.yml @@ -21,7 +21,7 @@ body: attributes: label: "📋 Page(s) affected (or suggested, for new content)" description: Please provide the URL of the page(s) affected. - placeholder: https://docs.solidjs.com/concepts/intro-to-reactivity + placeholder: https://docs.solidjs.com/concepts/reactivity validations: required: true - type: textarea diff --git a/.github/ISSUE_TEMPLATE/REQUEST.yml b/.github/ISSUE_TEMPLATE/REQUEST.yml index f1aef4ba5a..1d2755c3f3 100644 --- a/.github/ISSUE_TEMPLATE/REQUEST.yml +++ b/.github/ISSUE_TEMPLATE/REQUEST.yml @@ -23,7 +23,7 @@ body: attributes: label: "📋 Suggested" description: Please provide the URL of the page(s) or section this idea is related to. - placeholder: https://docs.solidjs.com/concepts/intro-to-reactivity + placeholder: https://docs.solidjs.com/concepts/reactivity validations: required: false - type: textarea diff --git a/PROPOSAL-solid-2.0-docs.md b/PROPOSAL-solid-2.0-docs.md index 6b93074375..5970fb8f07 100644 --- a/PROPOSAL-solid-2.0-docs.md +++ b/PROPOSAL-solid-2.0-docs.md @@ -14,10 +14,10 @@ The site is organized as four products (Solid, Router, Start, Meta), each with i Split into two sites, the way Vite handles major versions: -| Site | Contents | Status | -| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -| **v1.docs.solidjs.com** | The current site as it stands: core at `/`, Router 1, Meta 0.29, Start v1 + v2 (Start 2 runs on Solid 1, so it lives here) | Branched off and frozen in shape, maintained for fixes | -| **docs.solidjs.com** | One unified doc tree covering the Solid 2.0 platform, rebuilt from a clean starting point | The active effort | +| Site | Contents | Status | +| -------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | +| **v1.solidjs.com** | The current site as it stands: core at `/`, Router 1, Meta 0.29, Start v1 + v2 (Start 2 runs on Solid 1, so it lives here) | Branched off and frozen in shape, maintained for fixes | +| **docs.solidjs.com** | One unified doc tree covering the Solid 2.0 platform, rebuilt from a clean starting point | The active effort | Since everything is touched by Solid 2.0, branching the whole site beats threading version switches through every page. Each site links to the other from a banner. This is a one-time split for this transition, not a policy for every major version. diff --git a/netlify.toml b/netlify.toml index ae5277a8cb..382c285aa2 100644 --- a/netlify.toml +++ b/netlify.toml @@ -27,3 +27,164 @@ to = "https://docs.solidjs.com/:splat" status = 301 force = true + +# Solid 1 sections that 2.0 does not have moved to v1.solidjs.com with the same paths. +[[redirects]] + from = "/solid-start" + to = "https://v1.solidjs.com/solid-start" + status = 301 + +[[redirects]] + from = "/solid-start/*" + to = "https://v1.solidjs.com/solid-start/:splat" + status = 301 + +[[redirects]] + from = "/solid-router" + to = "https://v1.solidjs.com/solid-router" + status = 301 + +[[redirects]] + from = "/solid-router/*" + to = "https://v1.solidjs.com/solid-router/:splat" + status = 301 + +[[redirects]] + from = "/solid-meta" + to = "https://v1.solidjs.com/solid-meta" + status = 301 + +[[redirects]] + from = "/solid-meta/*" + to = "https://v1.solidjs.com/solid-meta/:splat" + status = 301 + +[[redirects]] + from = "/advanced-concepts" + to = "https://v1.solidjs.com/advanced-concepts" + status = 301 + +[[redirects]] + from = "/advanced-concepts/*" + to = "https://v1.solidjs.com/advanced-concepts/:splat" + status = 301 + +[[redirects]] + from = "/configuration" + to = "https://v1.solidjs.com/configuration" + status = 301 + +[[redirects]] + from = "/configuration/*" + to = "https://v1.solidjs.com/configuration/:splat" + status = 301 + +[[redirects]] + from = "/quick-start" + to = "https://v1.solidjs.com/quick-start" + status = 301 + +[[redirects]] + from = "/quick-start/*" + to = "https://v1.solidjs.com/quick-start/:splat" + status = 301 + +[[redirects]] + from = "/reference/basic-reactivity" + to = "https://v1.solidjs.com/reference/basic-reactivity" + status = 301 + +[[redirects]] + from = "/reference/basic-reactivity/*" + to = "https://v1.solidjs.com/reference/basic-reactivity/:splat" + status = 301 + +[[redirects]] + from = "/reference/component-apis" + to = "https://v1.solidjs.com/reference/component-apis" + status = 301 + +[[redirects]] + from = "/reference/component-apis/*" + to = "https://v1.solidjs.com/reference/component-apis/:splat" + status = 301 + +[[redirects]] + from = "/reference/components" + to = "https://v1.solidjs.com/reference/components" + status = 301 + +[[redirects]] + from = "/reference/components/*" + to = "https://v1.solidjs.com/reference/components/:splat" + status = 301 + +[[redirects]] + from = "/reference/jsx-attributes" + to = "https://v1.solidjs.com/reference/jsx-attributes" + status = 301 + +[[redirects]] + from = "/reference/jsx-attributes/*" + to = "https://v1.solidjs.com/reference/jsx-attributes/:splat" + status = 301 + +[[redirects]] + from = "/reference/lifecycle" + to = "https://v1.solidjs.com/reference/lifecycle" + status = 301 + +[[redirects]] + from = "/reference/lifecycle/*" + to = "https://v1.solidjs.com/reference/lifecycle/:splat" + status = 301 + +[[redirects]] + from = "/reference/reactive-utilities" + to = "https://v1.solidjs.com/reference/reactive-utilities" + status = 301 + +[[redirects]] + from = "/reference/reactive-utilities/*" + to = "https://v1.solidjs.com/reference/reactive-utilities/:splat" + status = 301 + +[[redirects]] + from = "/reference/rendering" + to = "https://v1.solidjs.com/reference/rendering" + status = 301 + +[[redirects]] + from = "/reference/rendering/*" + to = "https://v1.solidjs.com/reference/rendering/:splat" + status = 301 + +[[redirects]] + from = "/reference/secondary-primitives" + to = "https://v1.solidjs.com/reference/secondary-primitives" + status = 301 + +[[redirects]] + from = "/reference/secondary-primitives/*" + to = "https://v1.solidjs.com/reference/secondary-primitives/:splat" + status = 301 + +[[redirects]] + from = "/reference/server-utilities" + to = "https://v1.solidjs.com/reference/server-utilities" + status = 301 + +[[redirects]] + from = "/reference/server-utilities/*" + to = "https://v1.solidjs.com/reference/server-utilities/:splat" + status = 301 + +[[redirects]] + from = "/reference/store-utilities" + to = "https://v1.solidjs.com/reference/store-utilities" + status = 301 + +[[redirects]] + from = "/reference/store-utilities/*" + to = "https://v1.solidjs.com/reference/store-utilities/:splat" + status = 301 diff --git a/src/routes/(6)migration/(2)from-solid-start.mdx b/src/routes/(6)migration/(2)from-solid-start.mdx index 9f3e3eb484..f06d4d7054 100644 --- a/src/routes/(6)migration/(2)from-solid-start.mdx +++ b/src/routes/(6)migration/(2)from-solid-start.mdx @@ -59,7 +59,7 @@ Install the target dependencies first, then add application dependencies as thei ## Start from SolidStart 1 -[SolidStart 1](https://docs.solidjs.com/solid-start) uses Vinxi, Nitro, `app.config.ts`, and framework-owned entries. +[SolidStart 1](https://v1.solidjs.com/solid-start/v1) uses Vinxi, Nitro, `app.config.ts`, and framework-owned entries. Record the source behavior before changing files: 1. Record the value of `ssr`, the `appRoot`, the route directory, middleware paths, route prerendering, and every option under `server` in `app.config.ts`. @@ -88,7 +88,7 @@ Apply these source-specific rules: ## Start from released SolidStart 2 -[Released SolidStart 2](https://docs.solidjs.com/solid-start/v2) uses Solid 1, `solidStart()`, Vite environment builds, and a deployment plugin such as Nitro. +[Released SolidStart 2](https://v1.solidjs.com/solid-start/v2) uses Solid 1, `solidStart()`, Vite environment builds, and a deployment plugin such as Nitro. Its Vite configuration resembles the target, but the application and server contracts are different. Record the source behavior before changing files: From 890ce84896b67d7d7f1e00b40fecff7fa2586925 Mon Sep 17 00:00:00 2001 From: Brenley Dueck Date: Mon, 16 Nov 2026 17:23:03 -0600 Subject: [PATCH 2/2] docs: drop v1 path redirects from netlify.toml --- netlify.toml | 161 --------------------------------------------------- 1 file changed, 161 deletions(-) diff --git a/netlify.toml b/netlify.toml index 382c285aa2..ae5277a8cb 100644 --- a/netlify.toml +++ b/netlify.toml @@ -27,164 +27,3 @@ to = "https://docs.solidjs.com/:splat" status = 301 force = true - -# Solid 1 sections that 2.0 does not have moved to v1.solidjs.com with the same paths. -[[redirects]] - from = "/solid-start" - to = "https://v1.solidjs.com/solid-start" - status = 301 - -[[redirects]] - from = "/solid-start/*" - to = "https://v1.solidjs.com/solid-start/:splat" - status = 301 - -[[redirects]] - from = "/solid-router" - to = "https://v1.solidjs.com/solid-router" - status = 301 - -[[redirects]] - from = "/solid-router/*" - to = "https://v1.solidjs.com/solid-router/:splat" - status = 301 - -[[redirects]] - from = "/solid-meta" - to = "https://v1.solidjs.com/solid-meta" - status = 301 - -[[redirects]] - from = "/solid-meta/*" - to = "https://v1.solidjs.com/solid-meta/:splat" - status = 301 - -[[redirects]] - from = "/advanced-concepts" - to = "https://v1.solidjs.com/advanced-concepts" - status = 301 - -[[redirects]] - from = "/advanced-concepts/*" - to = "https://v1.solidjs.com/advanced-concepts/:splat" - status = 301 - -[[redirects]] - from = "/configuration" - to = "https://v1.solidjs.com/configuration" - status = 301 - -[[redirects]] - from = "/configuration/*" - to = "https://v1.solidjs.com/configuration/:splat" - status = 301 - -[[redirects]] - from = "/quick-start" - to = "https://v1.solidjs.com/quick-start" - status = 301 - -[[redirects]] - from = "/quick-start/*" - to = "https://v1.solidjs.com/quick-start/:splat" - status = 301 - -[[redirects]] - from = "/reference/basic-reactivity" - to = "https://v1.solidjs.com/reference/basic-reactivity" - status = 301 - -[[redirects]] - from = "/reference/basic-reactivity/*" - to = "https://v1.solidjs.com/reference/basic-reactivity/:splat" - status = 301 - -[[redirects]] - from = "/reference/component-apis" - to = "https://v1.solidjs.com/reference/component-apis" - status = 301 - -[[redirects]] - from = "/reference/component-apis/*" - to = "https://v1.solidjs.com/reference/component-apis/:splat" - status = 301 - -[[redirects]] - from = "/reference/components" - to = "https://v1.solidjs.com/reference/components" - status = 301 - -[[redirects]] - from = "/reference/components/*" - to = "https://v1.solidjs.com/reference/components/:splat" - status = 301 - -[[redirects]] - from = "/reference/jsx-attributes" - to = "https://v1.solidjs.com/reference/jsx-attributes" - status = 301 - -[[redirects]] - from = "/reference/jsx-attributes/*" - to = "https://v1.solidjs.com/reference/jsx-attributes/:splat" - status = 301 - -[[redirects]] - from = "/reference/lifecycle" - to = "https://v1.solidjs.com/reference/lifecycle" - status = 301 - -[[redirects]] - from = "/reference/lifecycle/*" - to = "https://v1.solidjs.com/reference/lifecycle/:splat" - status = 301 - -[[redirects]] - from = "/reference/reactive-utilities" - to = "https://v1.solidjs.com/reference/reactive-utilities" - status = 301 - -[[redirects]] - from = "/reference/reactive-utilities/*" - to = "https://v1.solidjs.com/reference/reactive-utilities/:splat" - status = 301 - -[[redirects]] - from = "/reference/rendering" - to = "https://v1.solidjs.com/reference/rendering" - status = 301 - -[[redirects]] - from = "/reference/rendering/*" - to = "https://v1.solidjs.com/reference/rendering/:splat" - status = 301 - -[[redirects]] - from = "/reference/secondary-primitives" - to = "https://v1.solidjs.com/reference/secondary-primitives" - status = 301 - -[[redirects]] - from = "/reference/secondary-primitives/*" - to = "https://v1.solidjs.com/reference/secondary-primitives/:splat" - status = 301 - -[[redirects]] - from = "/reference/server-utilities" - to = "https://v1.solidjs.com/reference/server-utilities" - status = 301 - -[[redirects]] - from = "/reference/server-utilities/*" - to = "https://v1.solidjs.com/reference/server-utilities/:splat" - status = 301 - -[[redirects]] - from = "/reference/store-utilities" - to = "https://v1.solidjs.com/reference/store-utilities" - status = 301 - -[[redirects]] - from = "/reference/store-utilities/*" - to = "https://v1.solidjs.com/reference/store-utilities/:splat" - status = 301