Skip to content

Replace migration guides with automated controller-based migration#23254

Closed
jhlodin wants to merge 8 commits into
mainfrom
jl/doc-15191-claude
Closed

Replace migration guides with automated controller-based migration#23254
jhlodin wants to merge 8 commits into
mainfrom
jl/doc-15191-claude

Conversation

@jhlodin

@jhlodin jhlodin commented May 5, 2026

Copy link
Copy Markdown
Contributor

https://cockroachlabs.atlassian.net/browse/DOC-15191

  • Copy migration content from Nishanth's branch into public documentation
  • Apply style edits

TODO: Assess technical accuracy, apply readability edits

jhlodin and others added 2 commits May 5, 2026 14:59
Replace the existing manual migration guides with automated
migration guides from helm-charts repository. The new guides
document the automatic migration controller that handles the
migration process with minimal manual intervention.

Sources:
- helm-charts/docs/migration/helm/controller_migration.md
- helm-charts/docs/migration/operator/controller_migration.md

Co-Authored-By: roachdev-claude <roachdev-claude-bot@cockroachlabs.com>
Apply CockroachDB documentation style guidelines to the migration
guides, including:

- Update introductions to match established documentation tone
- Add Preview callouts for CockroachDB Operator
- Change all step headings to imperative mood with proper casing
- Convert "Before You Begin" to "Before you begin" with proper formatting
- Add Jekyll callouts for important warnings and information
- Use Liquid variables for product names ({{ site.data.products.* }})
- Update terminology to match docs conventions (e.g., "Kubernetes" not "K8s")
- Format initial sections with proper Jekyll syntax

Co-Authored-By: roachdev-claude <roachdev-claude-bot@cockroachlabs.com>
@netlify

netlify Bot commented May 5, 2026

Copy link
Copy Markdown

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit b5a40b4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/6a2076678e7e860008210a95

@github-actions

github-actions Bot commented May 5, 2026

Copy link
Copy Markdown

@netlify

netlify Bot commented May 5, 2026

Copy link
Copy Markdown

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit b5a40b4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/6a2076679ac1df0008c2a76c

@netlify

netlify Bot commented May 5, 2026

Copy link
Copy Markdown

Netlify Preview

Name Link
🔨 Latest commit 2471f08
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69fa3ed1aa93fc000857cff4
😎 Deploy Preview https://deploy-preview-23254--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented May 5, 2026

Copy link
Copy Markdown

Netlify Preview

Name Link
🔨 Latest commit b5a40b4
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/6a207667b4d8ca000883142c
😎 Deploy Preview https://deploy-preview-23254--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@jhlodin jhlodin marked this pull request as ready for review May 11, 2026 18:16
jhlodin and others added 3 commits June 3, 2026 14:41
Add callout notes about the split-chart deployment pattern where
platform teams can pre-create node-reader RBAC through the operator
chart for multi-tenant environments. This update reflects new
documentation added to the helm-charts README files in PR #620.

The split-chart pattern allows tenant namespaces without cluster-scoped
RBAC permissions to use platform-provided node-reader ClusterRole and
ClusterRoleBinding instead of creating their own.

Changes:
- Add split-chart callout after node-reader cleanup in Helm migration guide
- Add split-chart callout after node-reader cleanup in Operator migration guide
- Include references to helm-charts README sections for detailed instructions

Co-Authored-By: roachdev-claude <roachdev-claude-bot@cockroachlabs.com>
@jhlodin

jhlodin commented Jun 4, 2026

Copy link
Copy Markdown
Contributor Author

Ported to cockroachlabs/docs: https://github.com/cockroachlabs/docs/pull/7

@jhlodin jhlodin closed this Jun 4, 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.

1 participant