docs: restructure Managed Postgres sidebar and add migration overview#62
Open
mintlify[bot] wants to merge 2 commits into
Open
docs: restructure Managed Postgres sidebar and add migration overview#62mintlify[bot] wants to merge 2 commits into
mintlify[bot] wants to merge 2 commits into
Conversation
Merged
6 tasks
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Port of upstream clickhouse/clickhouse-docs#6279: restructure the Managed Postgres sidebar into four functional groups and add a Data migration overview page.
Changes
products/managed-postgres/migrations/overview.mdx— decision guide comparing ClickPipes, PeerDB, pg_dump/pg_restore, and logical replication.products/managed-postgres/navigation.jsoninto four groups: Get started, Use it, Configure, Operate & reference. Data migration now sits next to Connection; Extensions is a nested group containing pg_clickhouse; Monitoring is a nested group.integrations/connectors/tools/pg_clickhouse/so existing file-path URLs continue to work.slug:field on the three pg_clickhouse pages to the new/cloud/managed-postgres/extensions/pg_clickhouse[/tutorial,/reference]slugs so the Docusaurus↔Mintlify slug map stays in sync.extensions.mdxandquickstart.mdxto point at the pg_clickhouse intro page._site/redirects.jsonfor the three old/integrations/pg_clickhouse[...]URLs.Ambiguities / divergences from upstream
<BetaBadge link=... galaxyTrack galaxyEvent="docs.managed-postgres.migration-overview-beta" />, but the MintlifyBetaBadgesnippet here doesn't accept those props yet and the sibling migration pages still use<PrivatePreviewBadge .../>. I matched the local convention (PrivatePreviewBadgewithslug="migration-overview"). A follow-up may want to port the full BetaBadge replacement (upstream PR #6259) and switch this page over.cloud/managed-postgres/migrations/clickpipes, but the Mintlify equivalent is stillproducts/managed-postgres/migrations/clickhouse-cloud.mdx. The overview page and the new sidebar both point atclickhouse-cloud, and the upstreamclickhouse-cloud → clickpipesredirect already exists.migrations/faqpage and links to it from the overview; no Mintlify equivalent exists, so that link is omitted from the overview here..github/pull_request_template.md) and thevercel.jsonchanges from the source PR are Docusaurus-side concerns and have no Mintlify counterpart; the equivalent redirect entries were added to_site/redirects.jsoninstead.Context
Triggered by merge to
restructure-managed-postgres-sidebaron clickhouse-docs (commit2a49607).Note
Low Risk
Documentation-only changes (navigation, new overview page, slug updates, redirects); no application or security logic.
Overview
Reorganizes Managed Postgres docs into four sidebar groups (Get started, Use it, Configure, Operate & reference) and adds a new Data migration overview that compares ClickPipes, PeerDB,
pg_dump/pg_restore, and logical replication.pg_clickhouse moves in the nav from Integrations → Data integrations to Configure → Extensions (files stay under
integrations/connectors/tools/pg_clickhouse/). Frontmatterslugvalues on the intro, tutorial, and reference pages switch to/cloud/managed-postgres/extensions/pg_clickhouse[...], with matching entries in_site/redirects.jsonfrom the old/integrations/pg_clickhouseURLs. Integrationsnavigation.jsondrops the nested pg_clickhouse group; the three MDX pages get minor heading normalization and a small typo fix in reference.Reviewed by Cursor Bugbot for commit 393a901. Bugbot is set up for automated code reviews on this repo. Configure here.