Skip to content

Docs: sync upstream clickhouse-operator docs updates#248

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/c8329da0
Open

Docs: sync upstream clickhouse-operator docs updates#248
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/c8329da0

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Syncs the docs/ directory from clickhouse/clickhouse-operator (commit 5f292b7, PR #243 by @arekborucki) into products/kubernetes-operator/ in this repo.

cc @arekborucki for review.

Changes

  • New page: guides/storage.mdx — dedicated "Storage and volumes" guide extracted from the configuration guide.
  • Updated: overview.mdx, all guides/*.mdx (configuration, introduction, monitoring, scaling, tls), all install/*.mdx (helm, kubectl, olm), and reference/api-reference.mdx — synced verbatim from upstream. Notable content changes:
    • guides/configuration.mdx: storage section trimmed (content moved to new storage.mdx).
    • guides/monitoring.mdx, guides/scaling.mdx, guides/tls.mdx: position bumped to make room for the new storage guide; tls.mdx clarifies the server keypair secret shape.
    • install/kubectl.mdx: now recommends --server-side --force-conflicts and documents the description-stripped CRD variant for client-side apply.
    • reference/api-reference.mdx: adds CABundleSelector type; adds additionalVolumeClaimTemplates field on cluster spec.
  • Navigation: added guides/storage between configuration and monitoring in products/kubernetes-operator/navigation.json to match upstream docs/navigation.json.

Conflicts / issues

  • reference/api-reference.mdx line 83 contains a literal <name> inside a markdown table cell (/var/lib/clickhouse/disks/<name>). MDX parses this as an unclosed JSX tag, which causes mint broken-links/mint validate to fail with:

    Syntax error - Unable to parse products/kubernetes-operator/reference/api-reference.mdx - Expected a closing tag for <name> before the end of tableData

    Per the sync instructions, the file is copied as-is and the fix should land upstream first (e.g. escape as &lt;name&gt; or wrap in backticks: `<name>`).

Context

Upstream commit: ClickHouse/clickhouse-operator@5f292b7 — "docs: extract storage related documentation as a dedicated guide (#243)".

@mintlify

mintlify Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview Jun 23, 2026, 2:16 PM

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