Skip to content

migrate new content#6

Closed
hasparus wants to merge 83 commits into
migrate-landingfrom
migrate-new-content
Closed

migrate new content#6
hasparus wants to merge 83 commits into
migrate-landingfrom
migrate-new-content

Conversation

@hasparus
Copy link
Copy Markdown
Collaborator

@hasparus hasparus commented Feb 5, 2026

New PR, but this will be merged together with #5.

What

git mvs the docs from the temporary Nextra dir pulled from Nextra commit by commit to the new structure in packages/documentation/

How

  1. Migration scripts — Added tools to fix broken links, frontmatter, and relative paths during the move
  2. Redirects — Preserved legacy URLs so existing bookmarks and links keep working
  3. Content relocation — Moved ~250 docs files and 143 image assets from temporary/ to the final location

n1ru4l and others added 30 commits January 13, 2026 17:28
… (#7478)

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Dotan Simha <dotansimha@gmail.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Piotr Monwid-Olechnowicz <hasparus@gmail.com>
…way to CDN modal (#7550)

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Laurin Quast <laurinquast@googlemail.com>
- Replace @apply dark:* with explicit :not(.light) selectors in
  hive-prose.css to fix PostCSS unclosed bracket error
- Add CJS package.json to .storybook/ for esbuild-register compat
Remove documentation Storybook (incompatible with Vite 7 + fumadocs).
CI now builds Storybook from design-system package only.
Add wrangler.toml for Cloudflare Workers deployment.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Feb 10, 2026

📚 Storybook Deployment

The latest changes are available as preview in: https://pr-6.the-guild-docs-storybook.pages.dev

@hasparus hasparus changed the title Migrate new content migrate new content Feb 14, 2026
@hasparus
Copy link
Copy Markdown
Collaborator Author

hasparus commented Feb 14, 2026

Visual Regression Report: Old Docs vs New Docs

Comparing 171 shared /docs pages between old (Nextra, :3000) and new (TanStack Start + Fumadocs, :1440).

odiff threshold: 0.1 (10% color tolerance), antialiasing detection enabled, viewport: 1440×900.

Summary

Metric Value
Total pages 171
Mean diff 15.0%
Median diff 13.2%
🟢 ≤10% diff 38 pages
🟡 10–30% diff 125 pages
🟠 30–60% diff 5 pages
🔴 >60% diff 3 pages

Diffs are expected — different doc frameworks (Nextra → Fumadocs). Navigation, headers, footers, and code block styling differ structurally. Content fidelity is the priority.

Remaining issues

  • Mermaid diagrams render as black boxes in the new framework
  • Self-hosting changelog (94.6% diff) — content should be generated as in the old repo
Full results (171 pages)
Status Path Diff %
🟡 /docs 11.01%
🟢 /docs/api-reference/cli 2.22%
🟡 /docs/api-reference/client 13.15%
🟠 /docs/api-reference/gateway-cli 35.80%
🟠 /docs/api-reference/gateway-config 17.50%
🟡 /docs/api-reference/graphql-api 9.72%
🟠 /docs/api-reference/graphql-api/access-token-management 16.25%
🟡 /docs/api-reference/graphql-api/contract-management 9.96%
🟠 /docs/api-reference/graphql-api/member-management 15.33%
🟡 /docs/api-reference/graphql-api/project-management 13.64%
🟡 /docs/api-reference/graphql-api/target-management 10.17%
🔴 /docs/api-reference/graphql-api/unused-deprecated-schema 62.03%
🟡 /docs/api-reference/link-specifications 12.21%
🟢 /docs/api-reference/php-client 3.36%
🟢 /docs/api-reference/ruby-client 3.40%
🟢 /docs/api-reference/rust-client 3.34%
🟠 /docs/api-reference/usage-reports 27.37%
🟡 /docs/gateway 10.87%
🟡 /docs/gateway/authorization-authentication 10.18%
🟡 /docs/gateway/defer-stream 11.77%
🟠 /docs/gateway/deployment 21.41%
🟠 /docs/gateway/deployment/docker 18.21%
🟠 /docs/gateway/deployment/node-frameworks/express 17.29%
🟠 /docs/gateway/deployment/node-frameworks/fastify 26.90%
🟠 /docs/gateway/deployment/node-frameworks/hapi 25.87%
🟠 /docs/gateway/deployment/node-frameworks/koa 15.54%
🟡 /docs/gateway/deployment/node-frameworks/nestjs 6.08%
🟡 /docs/gateway/deployment/node-frameworks/nextjs 9.77%
🟠 /docs/gateway/deployment/node-frameworks/sveltekit 17.11%
🟠 /docs/gateway/deployment/node-frameworks/uwebsockets 27.06%
🟡 /docs/gateway/deployment/resources-requirements 11.86%
🟡 /docs/gateway/deployment/runtimes/bun 12.13%
🟠 /docs/gateway/deployment/runtimes/deno 15.41%
🟠 /docs/gateway/deployment/runtimes/nodejs 18.69%
🟠 /docs/gateway/deployment/serverless 16.07%
🟠 /docs/gateway/deployment/serverless/aws-lambda 17.11%
🟡 /docs/gateway/deployment/serverless/azure-functions 13.66%
🟡 /docs/gateway/deployment/serverless/cloudflare-workers 10.30%
🟢 /docs/gateway/deployment/serverless/google-cloud-platform 3.76%
🟠 /docs/gateway/logging-and-error-handling 16.56%
🟠 /docs/gateway/monitoring-tracing 15.85%
🟢 /docs/gateway/other-features 4.16%
🟢 /docs/gateway/other-features/custom-plugins 2.18%
🟠 /docs/gateway/other-features/header-propagation 18.47%
🟡 /docs/gateway/other-features/performance 14.70%
🟡 /docs/gateway/other-features/performance/automatic-persisted-queries 10.17%
🟢 /docs/gateway/other-features/performance/compression 4.30%
🟡 /docs/gateway/other-features/performance/deduplicate-inflight-requests 14.22%
🟡 /docs/gateway/other-features/performance/execution-cancellation 9.87%
🟡 /docs/gateway/other-features/performance/http-caching 13.02%
🟡 /docs/gateway/other-features/performance/parsing-and-validation-caching 12.75%
🟠 /docs/gateway/other-features/performance/request-batching 19.14%
🟢 /docs/gateway/other-features/performance/response-caching 4.05%
🟡 /docs/gateway/other-features/performance/upstream-cancellation 6.54%
🟠 /docs/gateway/other-features/progressive-override 15.92%
🟡 /docs/gateway/other-features/rust-query-planner 10.35%
🟡 /docs/gateway/other-features/security 9.15%
🟡 /docs/gateway/other-features/security/audit-documents 11.81%
🟠 /docs/gateway/other-features/security/aws-sigv4 20.30%
🟠 /docs/gateway/other-features/security/block-field-suggestions 17.52%
🟠 /docs/gateway/other-features/security/character-limit 17.24%
🟡 /docs/gateway/other-features/security/cors 12.43%
🟡 /docs/gateway/other-features/security/csrf-prevention 12.93%
🟡 /docs/gateway/other-features/security/demand-control 14.64%
🟡 /docs/gateway/other-features/security/disable-introspection 13.86%
🟡 /docs/gateway/other-features/security/hmac-signature 14.36%
🟡 /docs/gateway/other-features/security/https 14.01%
🟠 /docs/gateway/other-features/security/max-aliases 20.42%
🟠 /docs/gateway/other-features/security/max-depth 18.50%
🟠 /docs/gateway/other-features/security/max-directives 19.43%
🟠 /docs/gateway/other-features/security/max-tokens 18.46%
🟡 /docs/gateway/other-features/security/rate-limiting 13.83%
🟢 /docs/gateway/other-features/testing 3.92%
🟡 /docs/gateway/other-features/testing/debugging 13.74%
🟠 /docs/gateway/other-features/testing/gateway-tester 26.08%
🟠 /docs/gateway/other-features/testing/mocking 20.05%
🟠 /docs/gateway/other-features/testing/snapshot 17.43%
🟠 /docs/gateway/other-features/upstream-reliability 16.41%
🟠 /docs/gateway/persisted-documents 18.83%
🟡 /docs/gateway/subscriptions 13.57%
🟡 /docs/gateway/supergraph-proxy-source 12.13%
🟠 /docs/gateway/usage-reporting 17.55%
🟠 /docs/logger 18.67%
🟡 /docs/migration-guides/gateway-v1-v2 14.26%
🟡 /docs/migration-guides/organization-access-tokens 11.44%
🟡 /docs/new-laboratory 11.45%
🟡 /docs/new-laboratory/collections 5.28%
🟡 /docs/new-laboratory/environment-variables 10.46%
🟡 /docs/new-laboratory/history 6.85%
🟡 /docs/new-laboratory/operations 7.56%
🟡 /docs/new-laboratory/preflight 11.56%
🟡 /docs/new-laboratory/schema-support 5.60%
🟡 /docs/other-integrations 14.12%
🟡 /docs/other-integrations/apollo-gateway 11.82%
🟡 /docs/other-integrations/apollo-router 13.99%
🟠 /docs/other-integrations/apollo-server 21.44%
🟡 /docs/other-integrations/ci-cd 9.50%
🟡 /docs/other-integrations/code-first 13.06%
🟡 /docs/other-integrations/envelop 5.13%
🟠 /docs/other-integrations/gqlgen-go 24.38%
🟡 /docs/other-integrations/grafbase-gateway 10.54%
🟡 /docs/other-integrations/graphql-code-generator 12.52%
🟡 /docs/other-integrations/graphql-ruby 13.28%
🟠 /docs/other-integrations/graphql-yoga 23.20%
🟡 /docs/other-integrations/lighthouse 13.03%
🟡 /docs/other-integrations/schema-stitching 12.34%
🟡 /docs/router 11.23%
🟡 /docs/router/configuration 9.99%
🟡 /docs/router/configuration/authorization 12.68%
🟡 /docs/router/configuration/cors 10.20%
🟡 /docs/router/configuration/csrf 14.87%
🟡 /docs/router/configuration/environment-variables 14.37%
🟡 /docs/router/configuration/expressions 5.55%
🟢 /docs/router/configuration/graphiql 2.76%
🟡 /docs/router/configuration/headers 8.87%
🟡 /docs/router/configuration/http 12.05%
🟡 /docs/router/configuration/introspection 12.73%
🟡 /docs/router/configuration/jwt 12.27%
🟠 /docs/router/configuration/limits 15.70%
🟡 /docs/router/configuration/log 11.31%
🟡 /docs/router/configuration/override_labels 12.95%
🟡 /docs/router/configuration/override_subgraph_urls 13.19%
🟡 /docs/router/configuration/query_planner 12.01%
🟡 /docs/router/configuration/supergraph 13.96%
🟡 /docs/router/configuration/traffic_shaping 10.78%
🔴 /docs/router/configuration/usage_reporting 79.43%
🟡 /docs/router/getting-started 11.91%
🟠 /docs/router/guides/dynamic-subgraph-routing 15.41%
🟡 /docs/router/guides/header-manipulation 14.77%
🟢 /docs/router/guides/performance-tuning 4.74%
🟡 /docs/router/observability/probes 10.17%
🟢 /docs/router/observability/usage_reporting 4.70%
🟠 /docs/router/security/authorization 15.83%
🟡 /docs/router/security/cors 12.98%
🟡 /docs/router/security/csrf 13.39%
🟡 /docs/router/security/introspection 10.66%
🟠 /docs/router/security/jwt-authentication 16.66%
🟡 /docs/router/security/operation-complexity 11.01%
🟠 /docs/router/supergraph 16.37%
🟡 /docs/schema-registry 11.81%
🟡 /docs/schema-registry/app-deployments 11.16%
🔴 /docs/schema-registry/contracts 46.83%
🟡 /docs/schema-registry/explorer 13.57%
🟡 /docs/schema-registry/external-schema-composition 11.52%
🟠 /docs/schema-registry/get-started/apollo-federation 24.26%
🟡 /docs/schema-registry/get-started/first-steps 14.56%
🟠 /docs/schema-registry/get-started/schema-stitching 21.96%
🟠 /docs/schema-registry/get-started/single-project 17.46%
🟡 /docs/schema-registry/high-availability-cdn 6.36%
🟡 /docs/schema-registry/high-availability-resilence 7.75%
🟡 /docs/schema-registry/laboratory 13.27%
🟡 /docs/schema-registry/laboratory/preflight-scripts 13.59%
🟠 /docs/schema-registry/management/access-tokens 34.96%
🟢 /docs/schema-registry/management/audit-logs 2.99%
🔴 /docs/schema-registry/management/members-roles-permissions 49.98%
🟡 /docs/schema-registry/management/organizations 7.07%
🟡 /docs/schema-registry/management/projects 14.52%
🔴 /docs/schema-registry/management/sso-oidc-provider 50.29%
🟠 /docs/schema-registry/management/targets 15.16%
🟠 /docs/schema-registry/schema-policy 16.88%
🟢 /docs/schema-registry/self-hosting/cdn-artifacts 2.55%
🔴 /docs/schema-registry/self-hosting/changelog 94.63%
🟠 /docs/schema-registry/self-hosting/client-and-cli-configuration 17.94%
🟡 /docs/schema-registry/self-hosting/external-composition 13.95%
🟢 /docs/schema-registry/self-hosting/get-started 4.42%
🟢 /docs/schema-registry/self-hosting/oidc-login 3.90%
🟡 /docs/schema-registry/self-hosting/s3-provider 9.01%
🟠 /docs/schema-registry/self-hosting/telemetry 15.31%
🟡 /docs/schema-registry/self-hosting/troubleshooting 12.32%
🟠 /docs/schema-registry/usage-reporting 17.17%
🟡 /docs/use-cases/apollo-graphos 6.40%
🔴 Pages with >60% diff (3 pages)
Path Diff %
/docs/schema-registry/self-hosting/changelog 94.63%
/docs/router/configuration/usage_reporting 79.43%
/docs/api-reference/graphql-api/unused-deprecated-schema 62.03%
🟠 Pages with 30–60% diff (5 pages)
Path Diff %
/docs/schema-registry/management/sso-oidc-provider 50.29%
/docs/schema-registry/management/members-roles-permissions 49.98%
/docs/schema-registry/contracts 46.83%
/docs/api-reference/gateway-cli 35.80%
/docs/schema-registry/management/access-tokens 34.96%

Generated by visually-same report — screenshots in packages/documentation/tests/visually-same/screenshots/

@hasparus hasparus closed this Mar 3, 2026
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.

8 participants