Skip to content

Restructure production docs - #629

Merged
qianl15 merged 10 commits into
mainfrom
qian/restructure-cloud
Sep 28, 2026
Merged

qianl15 merged 10 commits into
mainfrom
qian/restructure-cloud

Conversation

@qianl15

@qianl15 qianl15 commented Sep 26, 2026

Copy link
Copy Markdown
Member

Splits Conductor-specific docs from general production guidance.

  • Deploy to Production (docs/production/): general guides (production checklist, workflow recovery, Kubernetes, Cloud Run).
  • Operate with Conductor (docs/conductor/): Conductor overview, workflow management, retention, a new Distributed Recovery page, metrics, alerting, autoscaling, permissions, audit logs.
    • self-hosting/: a new platform-agnostic Self-Hosting Guide, plus the Kubernetes deployment guide.
    • reference/: Conductor API, dbosctl, and the DBOS Cloud docs (moved from production/dbos-cloud).
  • Old /production/*, /production/dbos-cloud/* and /cloud-tutorials/* URLs redirect to the new locations.
  • Links across the docs are updated; the build passes with no broken links.

qianl15 and others added 6 commits September 25, 2026 16:02
Move Conductor-specific pages from docs/production to docs/conductor,
with self-hosting and reference subfolders, and move DBOS Cloud docs to
docs/conductor/dbos-cloud. docs/production keeps the general guides
under a new "Deploy to Production" sidebar section.

- Redirect old /production and /cloud-tutorials URLs to the new paths
- Rewrite relative links to moved pages across the docs
- Move Conductor recovery details to a new Distributed Recovery page
- Point the home page Conductor cards at the Conductor overview

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Turn "Self-Hosting Conductor" into a platform-agnostic Self-Hosting
Guide covering components, production requirements (reverse proxy and
TLS, network access, secrets) and authentication. Retitle the
Kubernetes page "Deploying on Kubernetes" and link to the guide for
material that applies to any platform.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread docs/conductor/self-hosting/hosting-conductor.md Outdated

@maxdml maxdml left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the new structure

@qianl15
qianl15 merged commit 13aac82 into main Sep 28, 2026
1 check passed
@qianl15
qianl15 deleted the qian/restructure-cloud branch September 28, 2026 22:05
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.

3 participants