docs: restructure Managed Postgres sidebar and add migration overview#62
Open
mintlify[bot] wants to merge 1 commit into
Open
docs: restructure Managed Postgres sidebar and add migration overview#62mintlify[bot] wants to merge 1 commit into
mintlify[bot] wants to merge 1 commit into
Conversation
Open
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 and navigation-only changes with redirects for moved URLs; no application code or security-sensitive behavior.
Overview
This PR reorganizes Managed Postgres docs navigation into four groups (Get started, Use it, Configure, Operate & reference), moves Connection and a new Data migration subsection under Get started, nests Monitoring under Operate & reference, and adds
migrations/overview.mdxas a comparison guide for ClickPipes, PeerDB,pg_dump/pg_restore, and logical replication.pg_clickhouse is surfaced under Configure → Extensions in Managed Postgres and removed from Integrations → Data integrations; the MDX files stay at
integrations/connectors/tools/pg_clickhouse/but theirslugvalues move to/cloud/managed-postgres/extensions/pg_clickhouse[...], with matching_site/redirects.jsonentries from the old/integrations/pg_clickhouseURLs.Reviewed by Cursor Bugbot for commit 721c201. Bugbot is set up for automated code reviews on this repo. Configure here.