Skip to content

docs: update PXC deprecation notices to link to mgr-docs migration guide#28

Open
SuJinpei wants to merge 2 commits intomasterfrom
fix/pxc-migration-docs
Open

docs: update PXC deprecation notices to link to mgr-docs migration guide#28
SuJinpei wants to merge 2 commits intomasterfrom
fix/pxc-migration-docs

Conversation

@SuJinpei
Copy link
Copy Markdown
Contributor

@SuJinpei SuJinpei commented Mar 25, 2026

Summary by CodeRabbit

  • Documentation

    • Added deprecation notices across key documentation pages indicating MySQL-PXC is deprecated and no longer managed by the MySQL operator
    • Existing PXC clusters will continue running without operator updates
    • Included links to migration guide for users to transition to MySQL-MGR
  • Chores

    • Added MySQL-MGR site configuration

- Add mysql-mgr site entry to sites.yaml (version 4.3)
- Replace internal markdown links with ExternalSiteLink components
- Remove condensed migrate-to-mgr guide (comprehensive guide now in mgr-docs)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 25, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 606b9e0f-adc9-4c0d-ab9d-db1a02d9ecba

📥 Commits

Reviewing files that changed from the base of the PR and between d530a10 and 35586a8.

📒 Files selected for processing (1)
  • docs/en/upgrade.mdx
✅ Files skipped from review due to trivial changes (1)
  • docs/en/upgrade.mdx

Walkthrough

Five documentation pages were updated to add deprecation warnings for MySQL-PXC pointing to a MySQL-MGR migration guide, and a new mysql-mgr site entry was added to sites.yaml.

Changes

Cohort / File(s) Summary
Deprecation Callouts
docs/en/architecture.mdx, docs/en/index.mdx, docs/en/installation.mdx, docs/en/intro.mdx, docs/en/upgrade.mdx
Inserted :::warning deprecation notices stating MySQL-PXC is deprecated and no longer managed by the operator, directing users to migrate to MySQL-MGR via ExternalSiteLink to the migration guide.
Site Configuration
sites.yaml
Added new site entry mysql-mgr with base: /mysql-mgr, version: "4.3", and repo: https://github.com/alauda/mgr-docs.

Sequence Diagram(s)

(omitted — changes are documentation and site config only)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • Fix plugin name #11: Edits the same documentation pages to adjust MySQL-PXC messaging and introduce migration/renaming changes.

Poem

🐰 MySQL-PXC hops off, soft and light,
Toward MGR's meadow, gleaming bright,
A guide of breadcrumbs marks the way,
Clusters rest while we migrate today,
Hooray for fresh docs and a moonlit night! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the primary change: adding and updating deprecation notices across documentation files to link to a migration guide for MySQL-MGR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/pxc-migration-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@sites.yaml`:
- Around line 4-6: The sed that sets version (s/(version:).*/\1 \"$VERSION\"/)
is too broad and the branch regex release-([0-9]+\.[0-9]+) is fragile; instead
constrain updates to the acp site only (e.g., only modify the version key in the
block where "name: acp" appears) or use a YAML-aware tool (yq) to set
.sites[].version for the acp entry; strengthen branch extraction to accept
release[-/]<semver> variants (e.g., release[-/]([0-9]+(?:\.[0-9]+)*)(?:[-/].*)?)
with validation and fallback, and always escape the derived VERSION before
passing to sed (or use an alternate sed delimiter or printf %s to safely quote
it) so delimiter/slash characters cannot break the substitution.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6f39be5c-879a-4ddf-aea6-3be6b3778b78

📥 Commits

Reviewing files that changed from the base of the PR and between 73ee76f and d530a10.

📒 Files selected for processing (5)
  • docs/en/architecture.mdx
  • docs/en/index.mdx
  • docs/en/installation.mdx
  • docs/en/intro.mdx
  • sites.yaml

Comment on lines +4 to +6
- name: mysql-mgr
base: /mysql-mgr
version: "4.3"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

# 1) Confirm how many version keys exist now
rg -n '^\s*version:\s*' sites.yaml

# 2) Locate the failing workflow command and inspect context
rg -n 'sed -i -E "s/\(version:\)\.\*/\\1 \\"\\$VERSION\\"/"|version:|sites.yaml' .github -C 3 || true

# 3) Show whether replacement is globally applied (risk: rewrites multiple sites)
rg -n 's/\(version:\)\.\*/\\1' .github -C 5 || true

Repository: alauda/pxc-docs

Length of output: 2319


🏁 Script executed:

# Get full sites.yaml to understand structure
cat -n sites.yaml

Repository: alauda/pxc-docs

Length of output: 273


🏁 Script executed:

# Check if sed with this pattern would match all occurrences
# Simulate the sed behavior on a test file with multiple version: keys
cat > /tmp/test_sed.yaml << 'EOF'
- name: site1
  base: /site1
  version: "old1"
- name: mysql-mgr
  base: /mysql-mgr
  version: "old2"
EOF

# Test what the sed command would do
sed -E "s/(version:).*/\1 \"NEW_VERSION\"/" /tmp/test_sed.yaml

Repository: alauda/pxc-docs

Length of output: 174


🏁 Script executed:

# Check the workflow file for any additional context about branch handling
cat -n .github/workflows/main.yml

Repository: alauda/pxc-docs

Length of output: 1497


Scope version updates to the primary site only.

The current sed command s/(version:).*/\1 \"$VERSION\"/ matches all version: keys in sites.yaml, not just the intended one. This will overwrite both the acp version (line 3) and the mysql-mgr version (line 6) with the same value. Additionally, the branch extraction pattern release-([0-9]+\.[0-9]+) is fragile and will fail silently for branch names outside the release-X.Y format (e.g., release/5.0, release-5.0-hotfix), and the VERSION variable is unescaped in the sed command, risking delimiter conflicts if extraction produces unexpected values.

Use a YAML-aware approach or anchor the sed pattern to target only the acp site section, with proper input validation and escaping.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@sites.yaml` around lines 4 - 6, The sed that sets version (s/(version:).*/\1
\"$VERSION\"/) is too broad and the branch regex release-([0-9]+\.[0-9]+) is
fragile; instead constrain updates to the acp site only (e.g., only modify the
version key in the block where "name: acp" appears) or use a YAML-aware tool
(yq) to set .sites[].version for the acp entry; strengthen branch extraction to
accept release[-/]<semver> variants (e.g.,
release[-/]([0-9]+(?:\.[0-9]+)*)(?:[-/].*)?) with validation and fallback, and
always escape the derived VERSION before passing to sed (or use an alternate sed
delimiter or printf %s to safely quote it) so delimiter/slash characters cannot
break the substitution.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying alauda-mysql-pxc with  Cloudflare Pages  Cloudflare Pages

Latest commit: 35586a8
Status: ✅  Deploy successful!
Preview URL: https://58085280.alauda-mysql-pxc.pages.dev
Branch Preview URL: https://fix-pxc-migration-docs.alauda-mysql-pxc.pages.dev

View logs

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