Skip to content

Lead MySQL messaging with in-place MySQL Enterprise replacement positioning#180

Open
thefactremains wants to merge 4 commits into
mainfrom
mysql-enterprise-replacement-positioning
Open

Lead MySQL messaging with in-place MySQL Enterprise replacement positioning#180
thefactremains wants to merge 4 commits into
mainfrom
mysql-enterprise-replacement-positioning

Conversation

@thefactremains
Copy link
Copy Markdown
Member

Summary

Updates the canonical MySQL product messaging in products/mysql/messaging.md to lead with Percona Server for MySQL as an in-place replacement for MySQL Enterprise Edition.

This PR makes one change: it adds a new lead sub-theme, "In-place replacement for MySQL Enterprise Edition," as the first item under Customer Challenges and Value Alignment - MySQL (before Optimized TCO), with three value-linked bullets:

  • Drop-in compatibility: binary compatibility with the matching MySQL version, so teams move from Oracle MySQL Community or Enterprise Edition in place via standard MySQL upgrade and replication paths, keeping migration effort and downtime risk low. Cites the upgrade docs.
  • Open source equivalents for paid Enterprise capabilities: PAM and LDAP authentication, Audit Log, Data Masking, a connection Thread Pool, and keyring integration (HashiCorp Vault, KMIP, AWS KMS), provided as open source. FIPS-capable binaries ship in standard builds from Percona Server for MySQL 8.4.0-5 onward (FIPS mode depends on a FIPS-enabled host OpenSSL stack and documented configuration). Cites the feature-comparison and FIPS pages.
  • Capabilities beyond Enterprise Edition: MyRocks, expanded INFORMATION_SCHEMA and per-object performance counters, user statistics, extended slow query logging, binary log and temp file encryption, backup locks, and idle-transaction resource reclamation. Functional superset, no proprietary licensing or feature gating. Cites the feature-comparison page.

Rationale

Moves the most defensible competitive frame (in-place Enterprise Edition replacement) to the top of the page rather than leaving it implicit inside TCO. All claims are present tense, with engine scope inline and public docs.percona.com citations anchored at each claim.

New-file decision gate (reference/content-governance.md)

  1. Which existing files were reviewed first? products/mysql/messaging.md (the canonical MySQL product file).
  2. What exact gap was found? The page lacked a lead-position frame presenting Percona Server for MySQL as an in-place replacement for MySQL Enterprise Edition.
  3. Why can this not be an update to existing canonical files? It is an update to an existing canonical file. No new file is created.
  4. Who owns long-term maintenance? MySQL Product (domain owner per GOVERNANCE.md and CODEOWNERS).
  5. Decomposition and propagation plan? See follow-ups below; security and cost value pillars should reference, not duplicate, these claims.

Propagation follow-ups

  • The Security, Sovereignty, and Compliance value pillar should reference, not duplicate, the open source Enterprise-equivalent auth, audit, encryption, and FIPS claims.
  • The cost and TCO value pillar should reference, not duplicate, the licensing and feature-gating points.
  • No competitive intelligence or internal talk tracks were added (public repo, CC BY 4.0).

Verification

  • npx -y markdownlint-cli2@0.22.1 "products/mysql/messaging.md" passes with 0 errors.
  • Grep confirmed: no em dashes, no hyphenated "open-source", no standalone "Pro", "Pro build", or Pro tier wording, no "flag" as a verb, no competitive upstream-ownership talk tracks.
  • Vale CLI is not installed in this environment, so the Vale pass was not run locally; CI will run it.

Base branch

Based on main. PR #172 (ingest/pr-14-mysql-tracker-deltas) is already merged into main (merge commit 591b1d5), so this branch already includes that content and has no ordering dependency.

Needs SME pass before merge

The Enterprise Edition parity and superset claims, and the FIPS-capable standard builds from 8.4.0-5 version detail, need a product-SME accuracy pass before merge.

…ioning

Update products/mysql/messaging.md to position Percona Server for MySQL as
an in-place replacement for MySQL Enterprise Edition.

Add a new lead sub-theme "In-place replacement for MySQL Enterprise
Edition" as the first item under Customer Challenges and Value Alignment,
covering drop-in binary compatibility, open source equivalents for paid
Enterprise capabilities, and capabilities beyond Enterprise Edition.

All claims cite public docs.percona.com pages inline. Present-tense
capability framing, engine scope inline, no competitive intelligence or
internal talk tracks. markdownlint-cli2 passes with 0 errors.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

Messaging Smart Suggestions

File Why impacted Claim Confidence
reference/canonical-naming.md License and open source positioning changes are cross-cutting. cost 0.95
reference/banned-terms.md License and open source positioning changes are cross-cutting. cost 0.95
framework/core-positioning.md License and open source positioning changes are cross-cutting. cost 0.95
framework/why-percona.md License and open source positioning changes are cross-cutting. cost 0.95
offerings/expert-support.md License and open source positioning changes are cross-cutting. cost 0.95
offerings/expertops.md License and open source positioning changes are cross-cutting. cost 0.95
offerings/expert-consulting.md License and open source positioning changes are cross-cutting. cost 0.95
framework/core-positioning.md Product messaging modules often need checks against company framing and shared pillars or offerings. cost 0.95
framework/why-percona.md Product messaging modules often need checks against company framing and shared pillars or offerings. cost 0.95

Only auto-apply suggestions at high confidence with reviewer approval.


Triggered by pull_request. Workflow smart-suggestions.yml. Docs: AUTOMATION.md, automation/README.md.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

Messaging Impact Check

  • Changed files: 3

licensing-or-open-source-claims (BLOCKING)

License and open source positioning changes are cross-cutting.

Required review files:

  • reference/canonical-naming.md
  • reference/banned-terms.md
  • framework/core-positioning.md
  • framework/why-percona.md
  • offerings/expert-support.md
  • offerings/expertops.md
  • offerings/expert-consulting.md

Suggested additional scan:

  • use-cases-value-pillars/*.md
  • products/**/messaging.md

product-messaging-module-touch (WARN)

Product messaging modules often need checks against company framing and shared pillars or offerings.

Required review files:

  • framework/core-positioning.md
  • framework/why-percona.md

Suggested additional scan:

  • use-cases-value-pillars/*.md
  • offerings/*.md

Manual waiver commands (maintainers):

  • /impact-ok all (optional same-line note after all is ignored)
  • /impact-all (same as /impact-ok all)
  • /impact-ok <exact missing path>
  • /impact-reset all
  • /impact-reset <exact missing path>

Waiver state is stored in <!-- messaging-impact-waiver-data:v1 -->.


Triggered by pull_request. Workflow impact-check.yml. Docs: AUTOMATION.md, automation/README.md.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

New File Governance Check

No added markdown files detected.

Doc Coverage Check

No new markdown docs detected.

Duplicate Detector

  • Changed markdown docs: 3

No significant overlap detected.

Manual waiver commands (maintainers)

  • /governance-ok all or /governance-all
  • /governance-ok new-file, /governance-ok doc-coverage, /governance-ok duplicate
  • /governance-reset all or /governance-reset with the same token

Waiver JSON is stored in a hidden PR comment (messaging-governance-waiver-data:v1), same pattern as Impact Check.


Triggered by pull_request. Workflow content-governance-checks.yml. Docs: AUTOMATION.md, automation/README.md.

@brianamarie
Copy link
Copy Markdown
Collaborator

Hello @thefactremains! Thank you so much for opening this PR.

heckyeah

I've tried not to change any of the meaning or context, but have made some changes for information architecture and flow. Please feel free to edit again, make suggested changes, comments, whatever makes sense - and I'm happy to jump on a call if there's anything to talk through. 😊

I know I'd been hesitant about the 'drop in' claim, and I'm happy we can lean into it fully. After merging this (and likely #181 but this is headline) I'll:

  • Propagate to the pitch deck, datasheet
  • Refresh growth, bdr, customer facing teams about refinement in messaging so they're also pointed to the right things for ads, outreach, etc.

…e to pillars.

Reorganize products/mysql/messaging.md to lead with in-place MySQL Enterprise
replacement: Enterprise parity and Beyond Enterprise capability map, with
value-linked detail in TCO, Performance, Security, and Adaptability. Add
drop-in migration framing, MariaDB Galera context for PXC positioning, PXC
versus Group Replication as complementary HA paths, and FIPS in all supported
PS builds from 8.4.7 plus PXC (standard builds; host OpenSSL required).

Add short cross-references in cost-optimization and security-sovereignty-compliance
value pillars. Comparison tables remain a follow-on track.

Needs SME pass: confirm FIPS 8.4.7 and PXC FIPS scope before merge.

Co-authored-by: Cursor <cursoragent@cursor.com>
@brianamarie
Copy link
Copy Markdown
Collaborator

(fyi - about to make a few more tweaks for architecture consistency, will push in a minute)

Move in-place Enterprise replacement spine and Enterprise parity /
Beyond Enterprise capability map under Optimized TCO as the lead bullets,
matching the Customer Challenges layout used by other product messaging
files. Feature detail remains in Performance, Security, and Adaptability;
sales enablement unchanged.

Co-authored-by: Cursor <cursoragent@cursor.com>
Copy link
Copy Markdown
Member Author

@thefactremains thefactremains left a comment

Choose a reason for hiding this comment

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

Review: comment only. Verified against gh pr diff 180 (merge base 08855202), 3 files: products/mysql/messaging.md, use-cases-value-pillars/cost-optimization.md, use-cases-value-pillars/security-sovereignty-compliance.md. Strong update overall. Three items before merge.

  1. (Should-fix before merge) In products/mysql/messaging.md, the "High availability without vendor roadmap dependency" bullet opens with a competitive talk track: "After MariaDB nearly removed Galera from Community Server in 2026 (and walked back only after community outcry)...". Per reference/content-governance.md, competitive intelligence and internal talk tracks belong in private systems, not this public CC BY 4.0 repo, and per reference/brand-voice.md, canonical copy should not disparage a competitor. Suggest neutral, customer-facing wording, for example: "Percona XtraDB Cluster runs Percona's own open source Galera fork for synchronous multi-primary HA with split-brain prevention and WAN-friendly weighted quorum, a vendor-independent HA home that does not depend on another vendor's roadmap." Keep the Group Replication sentence as-is.

  2. (Accuracy) FIPS version. The copy states FIPS-capable binaries ship as of "8.4.7" in four added lines: the Enterprise parity bullet, the "FIPS for regulated environments" bullet, and the FIPS conversation starter (all in products/mysql/messaging.md), plus the security-sovereignty-compliance.md cross-reference. The authoritative fips.md doc and this PR's own description say 8.4.0-5, and the line this PR replaces also read 8.4.0-5. Recommend correcting 8.4.7 to 8.4.0-5, or confirming the exact version with a product SME before merge. The PR description already lists this as needing an SME pass.

  3. (Minor) The new link https://www.percona.com/compare-mysql-mongodb-postgresql-mariadb resolves (HTTP 200). It replaced the previous docs.percona.com feature-comparison URL, so please confirm this marketing comparison page is the intended "feature comparison" target rather than a docs feature-comparison page.

@thefactremains
Copy link
Copy Markdown
Member Author

Follow-up on item 3 (feature comparison link): the docs page that substantiates the Enterprise-parity and "95 vs 65" claims is Percona Server for MySQL feature comparison. It is a Percona Server vs MySQL (Community) feature table and is the direct source for several specifics in this PR (INFORMATION_SCHEMA 95 vs 65, MyRocks, per-object counters, binary log and temp file encryption, PAM and HashiCorp Vault keyring marked Enterprise-only in MySQL).

The currently linked https://www.percona.com/compare-mysql-mongodb-postgresql-mariadb is a marketing page comparing four engines (MySQL, MongoDB, PostgreSQL, MariaDB), which is a different comparison. Suggest either citing the docs feature-comparison page as the "feature comparison" target, or keeping both with distinct link text (docs page for the feature evidence, marketing page for the engine-level overview).

Correct FIPS version to 8.4.0-5, neutralize the PXC HA bullet, and cite
the docs PS vs MySQL feature comparison for Enterprise feature claims.
Refine cost and security pillar copy: fold scoped in-place Enterprise
language into licensing, split SOSoC encryption from audit/access with
cross-engine outcome framing.

Co-authored-by: Cursor <cursoragent@cursor.com>
@brianamarie
Copy link
Copy Markdown
Collaborator

Thank you @thefactremains - please take a peek at the newest changes when you get a chance

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