chore(docs): migrate hosting from Netlify to Cloudflare Pages

Switch the Nitro preset to cloudflare_pages and move all legacy 301
redirects into public/_redirects using Cloudflare's native :splat syntax
(dropping the Netlify-only '!' force suffix and the '**' placeholders
Nitro emits for routeRule redirects, which Cloudflare Pages cannot parse).

Port the immutable asset cache-control headers into public/_headers and
pin Node 22 via .nvmrc for reproducible Cloudflare builds.

Author: binaryk

docs-v3/.nvmrc

@@ -0,0 +1 @@
+22

docs-v3/nuxt.config.ts

@@ -127,32 +127,23 @@ export default defineNuxtConfig({
     }
   },
 
-  // 301 redirects from the legacy docs-v2 URL structure to the new /docs/* paths.
-  // Removes the duplicate soft-404 pages Ahrefs flagged and preserves old backlinks.
-  // Note: bare exact-match legacy paths (/quickstart, /repositories, /search) are
-  // handled via public/_redirects with forced (301!) rules. Exact-match redirect
-  // routeRules get prerendered as meta-refresh stub HTML files, which Netlify then
-  // serves with a 200 (shadowing the redirect) — so they must NOT live here.
-  routeRules: {
-    '/api/**': { redirect: { to: '/docs/api/**', statusCode: 301 } },
-    '/auth/**': { redirect: { to: '/docs/auth/**', statusCode: 301 } },
-    '/search/**': { redirect: { to: '/docs/search/**', statusCode: 301 } },
-    '/graphql/**': { redirect: { to: '/docs/graphql/**', statusCode: 301 } },
-    '/mcp/**': { redirect: { to: '/docs/mcp/**', statusCode: 301 } },
-    '/performance/**': { redirect: { to: '/docs/performance/**', statusCode: 301 } },
-    '/boost/**': { redirect: { to: '/docs/boost/**', statusCode: 301 } },
-    '/testing/**': { redirect: { to: '/docs/testing/**', statusCode: 301 } }
-  },
+  // 301 redirects from the legacy docs-v2 URL structure to the new /docs/* paths
+  // (preserves old backlinks and removes the duplicate soft-404 pages Ahrefs flagged)
+  // live in public/_redirects, authored in Cloudflare Pages' native syntax (:splat,
+  // no forced-'!' suffix). They are intentionally NOT expressed as Nuxt routeRules:
+  // Nitro emits routeRule redirects into _redirects using '**' placeholders, which
+  // Cloudflare Pages does not understand, and exact-match rules would additionally be
+  // prerendered as meta-refresh stub HTML that shadows the redirect with a 200.
 
   // TypeScript configuration
   typescript: {
     typeCheck: false
   },
 
-  // Static site generation for Netlify
+  // Static site generation for Cloudflare Pages
   ssr: true,
   nitro: {
-    preset: 'netlify-static',
+    preset: 'cloudflare_pages',
     prerender: {
       failOnError: false,
       crawlLinks: true,

docs-v3/public/_headers

@@ -0,0 +1,10 @@
+# Long-lived immutable caching for hashed build assets.
+# Ported from the previous Netlify config; Cloudflare Pages uses the same _headers format.
+/_nuxt/builds/meta/*
+  cache-control: public, max-age=31536000, immutable
+/_nuxt/builds/*
+  cache-control: public, max-age=1, immutable
+/_fonts/*
+  cache-control: public, max-age=31536000, immutable
+/_nuxt/*
+  cache-control: public, max-age=31536000, immutable

docs-v3/public/_redirects

@@ -1,4 +1,18 @@
-# Forced 301s for legacy docs-v2 bare paths (override any static file / SPA fallback)
-/quickstart      /docs/getting-started/quickstart  301!
-/repositories    /docs/api/repositories            301!
-/search          /docs/search/basic-filters        301!
+# Legacy docs-v2 URL structure -> new /docs/* paths. 301 to preserve backlinks/SEO.
+# Cloudflare Pages _redirects: '*' greedily captures the tail, placed back via ':splat'.
+# First matching rule wins, so exact-match rules must precede their wildcard counterparts.
+
+# Bare exact-match legacy paths
+/quickstart      /docs/getting-started/quickstart  301
+/repositories    /docs/api/repositories            301
+/search          /docs/search/basic-filters        301
+
+# Wildcard section redirects
+/api/*           /docs/api/:splat          301
+/auth/*          /docs/auth/:splat         301
+/search/*        /docs/search/:splat       301
+/graphql/*       /docs/graphql/:splat      301
+/mcp/*           /docs/mcp/:splat          301
+/performance/*   /docs/performance/:splat  301
+/boost/*         /docs/boost/:splat        301
+/testing/*       /docs/testing/:splat      301