From 0d1d30120eeffbdca53a89c09738e6974a03e53e Mon Sep 17 00:00:00 2001
From: Patrick Birch <48594400+patrickbirch@users.noreply.github.com>
Date: Wed, 18 Dec 2024 11:19:32 -0600
Subject: [PATCH] PS-9592 [DOCS] - Update yum-repo with mysql limitation 8.4

	modified:   docs/yum-repo.md
---
 docs/apt-repo.md     |  2 --
 docs/installation.md |  2 --
 docs/upgrade.md      |  3 ---
 docs/yum-repo.md     | 22 ++++++++++++++--------
 4 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/docs/apt-repo.md b/docs/apt-repo.md
index 61b8f5e206c..ea59248ede2 100644
--- a/docs/apt-repo.md
+++ b/docs/apt-repo.md
@@ -13,8 +13,6 @@ The DEB builds for Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, DEBIAN 11, and DEBI
 
 ## Install Percona Server for MySQL using APT
 
---8<--- "percona-release.md"
-
 To install Percona Server for MySQL using APT, do the following steps:
 {.power-number}
 
diff --git a/docs/installation.md b/docs/installation.md
index a7eb5600c0f..65cddfb8c18 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -6,8 +6,6 @@ We gather [Telemetry data] in the Percona packages and Docker images.
 
 ## Install Percona Server for MySQL from Repositories
 
---8<--- "percona-release.md"
-
 Percona provides repositories for yum (`RPM` packages for Red Hat, CentOS and Amazon Linux AMI) and apt (`.deb` packages for Ubuntu and Debian) for software such as Percona Server for MySQL, Percona XtraBackup, and Percona Toolkit. This makes it easy to install and update your software and its dependencies through your operating system’s package manager. This is the recommended way of installing where possible.
 
 The following guides describe the installation process for using the official Percona repositories for the `.deb` and `.rpm` packages.
diff --git a/docs/upgrade.md b/docs/upgrade.md
index 99064dd9729..afe702eb4c0 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -50,6 +50,3 @@ The following list summarizes a number of the changes in the 8.0 series and has
 
 Review other [Percona blogs](https://www.percona.com/blog/) that contain upgrade information.
 
-## Limitations
-
---8<--- "percona-release.md"
diff --git a/docs/yum-repo.md b/docs/yum-repo.md
index 436d1d4d5c0..51c461a805b 100644
--- a/docs/yum-repo.md
+++ b/docs/yum-repo.md
@@ -20,18 +20,24 @@ Percona Server for MySQL is certified for Red Hat Enterprise Linux 8. This certi
 
 The RPM builds for *RHEL* 8 and *RHEL* 9 contain ARM packages with the `aarch64.rpm` extension. This means that Percona Server for MySQL is available for users on ARM-based systems.
 
-## Install
+## Limitations
+
+RHEL 8 and other EL8 systems enable the MySQL module by default. This module hides the Percona-provided packages and the module must be disabled to make these packages visible. The following command disables the module:
 
---8<--- "percona-release.md"
+```{.bash data-prompt="$"}
+$ sudo yum module disable mysql
+```
+
+## Install
 
 To install using the Percona Software repository, run the following commands either as a `root` user or, as in the example, using `sudo`.
 
-    ```{.bash data-prompt="$"}
-    $ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
-    $ sudo percona-release enable-only {{pkg}} release
-    $ sudo percona-release enable tools release
-    $ sudo yum install percona-server-server
-    ```
+```{.bash data-prompt="$"}
+$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
+$ sudo percona-release enable-only {{pkg}} release
+$ sudo percona-release enable tools release
+$ sudo yum install percona-server-server
+```
 
 ## Available storage engines