Skip to content

Comments

Fix the doc for same major version sync#36

Open
rasika-chivate wants to merge 1 commit intomainfrom
fix_the-doc_for-same_major_version_sync
Open

Fix the doc for same major version sync#36
rasika-chivate wants to merge 1 commit intomainfrom
fix_the-doc_for-same_major_version_sync

Conversation

@rasika-chivate
Copy link
Collaborator

@rasika-chivate rasika-chivate commented Feb 20, 2026

Fix the contradiction in the PCSM documentation.

https://docs.percona.com/percona-clustersync-for-mongodb/index.html#why-you-need-pcsm
• Data migration:
PCSM simplifies the process of migrating data between clusters, whether you’re upgrading to a new MongoDB version, moving to a different vendor, or transitioning from cloud to on-premises.

But then...
https://docs.percona.com/percona-clustersync-for-mongodb/deployment.html#version-requirements
Version requirements

You can synchronize Percona Server for MongoDB or MongoDB Community/Enterprise Advanced/Atlas within the same major versions - 6.0 to 6.0, 7.0 to 7.0, 8.0 to 8.0.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR resolves a documentation contradiction about PCSM supporting data migration “when upgrading to a new MongoDB version” while the product only supports synchronization within the same MongoDB major version.

Changes:

  • Removes the “upgrading to a new MongoDB version” claim from the “Data migration” use case on the docs landing page.
  • Adds a clarification note in the FAQ that source and target must be on the same major version during sync.
  • Emphasizes “same major versions only” in the deployment version requirements section.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/index.md Removes wording that implied cross-version upgrades during sync.
docs/faq.md Adds a note clarifying same-major-version requirement during sync.
docs/deployment.md Reinforces same-major-version-only synchronization requirement.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +17 to +18
!!! note
PCSM supports MongoDB 6.0.17+, 7.0.13+, 8.0.0+ but source and target must be on the same major version during sync.
Copy link

Copilot AI Feb 20, 2026

Choose a reason for hiding this comment

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

The admonition is indented by 4 spaces here, which will typically make it render as a code block instead of a MkDocs/Material note. Align !!! note to the left margin (and keep the following content indented) so the admonition is parsed correctly.

Suggested change
!!! note
PCSM supports MongoDB 6.0.17+, 7.0.13+, 8.0.0+ but source and target must be on the same major version during sync.
!!! note
PCSM supports MongoDB 6.0.17+, 7.0.13+, 8.0.0+ but source and target must be on the same major version during sync.

Copilot uses AI. Check for mistakes.
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.

2 participants