Skip to content

docs(deployment): retire the Vercel and ObjectQL-migration pages, re-point their inbound redirects, and fix the prose links into them#8947

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-zhuang merged 1 commit into from
Aug 16, 2026
Merged

docs(deployment): retire the Vercel and ObjectQL-migration pages, re-point their inbound redirects, and fix the prose links into them #8947

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions .claude/workflows/docs-accuracy-audit.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -98,15 +98,13 @@ const ALL_HANDWRITTEN = [
"content/docs/deployment/cli.mdx",
"content/docs/deployment/environment-variables.mdx",
"content/docs/deployment/index.mdx",
"content/docs/deployment/migration-from-objectql.mdx",
"content/docs/deployment/production-readiness.mdx",
"content/docs/deployment/publish-and-preview.mdx",
"content/docs/deployment/self-hosting.mdx",
"content/docs/deployment/single-project-mode.mdx",
"content/docs/deployment/tenancy-modes.mdx",
"content/docs/deployment/troubleshooting.mdx",
"content/docs/deployment/validating-metadata.mdx",
"content/docs/deployment/vercel.mdx",
"content/docs/getting-started/build-with-claude-code.mdx",
"content/docs/getting-started/common-patterns.mdx",
"content/docs/getting-started/examples.mdx",
Expand Down
13 changes: 11 additions & 2 deletions apps/docs/redirects.mjs
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -92,14 +92,23 @@ export const docsRedirects = [
['/docs/concepts/cluster-semantics', '/docs/kernel/cluster'],
// deployment
['/docs/guides/cloud-deployment', '/docs/deployment'],
['/docs/guides/deployment-vercel', '/docs/deployment/vercel'],
['/docs/guides/deployment-vercel', '/docs/deployment/self-hosting'],
['/docs/guides/production-readiness', '/docs/deployment/production-readiness'],
['/docs/guides/publish-and-preview', '/docs/deployment/publish-and-preview'],
['/docs/guides/environment-variables', '/docs/deployment/environment-variables'],
['/docs/guides/single-project-mode', '/docs/deployment/single-project-mode'],
['/docs/concepts/cloud-artifact-api', '/docs/deployment/cloud-artifact-api'],
['/docs/guides/objectql-migration', '/docs/deployment/migration-from-objectql'],
['/docs/guides/objectql-migration', '/docs/deployment'],
['/docs/guides/troubleshooting', '/docs/deployment/troubleshooting'],
// Retired deployment pages (maintainer ruling 2026-08-15). Docker /
// self-hosting is the shipping path, so the Vercel guide lands on
// self-hosting; the `@objectql/core` port guide has no successor page, so it
// lands on the section index. The two `/docs/guides/*` entries ABOVE are
// re-pointed at these same destinations rather than left aimed here: Next
// matches this table once per request, so a chained entry would cost the old
// URLs a second round trip (and every redirect hop is SEO signal lost).
['/docs/deployment/vercel', '/docs/deployment/self-hosting'],
['/docs/deployment/migration-from-objectql', '/docs/deployment'],
// protocol / releases
['/docs/guides/cheatsheets/protocol-diagram', '/docs/protocol/diagram'],
['/docs/guides/cheatsheets/backward-compatibility', '/docs/protocol/backward-compatibility'],
Expand Down
2 changes: 0 additions & 2 deletions content/docs/deployment/meta.json
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,13 +6,11 @@
"validating-metadata",
"self-hosting",
"backup-restore",
"vercel",
"production-readiness",
"publish-and-preview",
"environment-variables",
"single-project-mode",
"tenancy-modes",
"migration-from-objectql",
"troubleshooting"
]
}
179 changes: 0 additions & 179 deletions content/docs/deployment/migration-from-objectql.mdx
View file
Open in desktop

This file was deleted.

4 changes: 1 addition & 3 deletions content/docs/deployment/self-hosting.mdx
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -7,8 +7,7 @@ description: Run a compiled ObjectStack app on your own infrastructure — bare

This guide takes the artifact produced by `os build` / `os compile` and runs it
on infrastructure **you** operate: a Linux host, a Docker container, or a
compose stack with Postgres. It complements the platform-specific
[Vercel guide](/docs/deployment/vercel) and assumes you have read
compose stack with Postgres. It assumes you have read
[Deployment Modes](/docs/deployment).

The deployment model is deliberately simple:
Expand DownExpand Up@@ -421,5 +420,4 @@ Disable with `OS_MCP_SERVER_ENABLED=false`. See
- [Deployment Modes](/docs/deployment) — the map of local / standalone / Cloud
- [`os start` reference](/docs/deployment/cli#os-start) — every flag and env var
- [Environment Variables](/docs/deployment/environment-variables) — the full catalog
- [Deploy to Vercel](/docs/deployment/vercel) — the serverless alternative
- [Troubleshooting & FAQ](/docs/deployment/troubleshooting)
Loading
Loading