PS-10109 [DOCS] - Review and update apt-repo 8.4

	modified:   docs/apt-pinning.md
	modified:   docs/apt-repo.md

Author: patrickbirch

docs/apt-pinning.md

@@ -1,15 +1,53 @@
 # Apt pinning the Percona Server for MySQL {{vers}} packages
 
-Pinning allows you to stay on a release and get packages from a different version. In some cases, you can pin selected packages and avoid accidentally upgrading all the packages. 
+Apt pinning helps you control which version of a package is installed from different repositories. This is useful when you want to stay on a specific release such as Percona Server for MySQL 8.4 and avoid automatic upgrades from other sources.
 
-The pinning takes place in the `preference` file. To pin a package, set the `Pin-Priority` to higher numbers. 
- 
-Make a new file `/etc/apt/preferences.d/00percona.pref`. For example, add the following to the `preference` file:
+## Steps to pin Percona Server for MySQL 8.4
+
+### Step 1: Create a Preferences file
+
+Open the directory located at `/etc/apt/preferences.d/` and create a new file named `00percona.pref`.
+
+```bash
+sudo nano /etc/apt/preferences.d/00percona.pref
+```
+
+### Step 2: Add the Pinning configuration
+
+Insert the following content into the file:
 
 ```text
-Package: 
-Pin: release o=Percona Development Team
+Package: percona-server-server
+Pin: release o=Percona Development Team,a=stable
 Pin-Priority: 1001
 ```
 
-For more information about the pinning, you can check the official [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
+The Package field specifies the exact name of the package.
+
+The Pin field identifies the origin of the package, which is the Percona repository.
+
+The Pin-Priority field sets the priority level. A value above 1000 ensures this version is preferred over others.
+
+Save and close the file.
+
+### Step 3: Update package lists
+
+Run the following command to refresh your package sources:
+
+```bash
+sudo apt update
+```
+
+### Step 4: Install the pinned package
+
+Install Percona Server for MySQL 8.4 using the following command:
+
+```bash
+sudo apt install percona-server-server
+```
+
+Your system prioritize the version from the Percona respository according to your pinning settings.
+
+## Learn more
+
+For additional details, visit the [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).

docs/apt-repo.md

@@ -1,24 +1,23 @@
-# Use an APT repository to install Percona Server for MySQL {{vers}}
+# Install Percona Server for MySQL {{vers}} Using APT on Debian/Ubuntu 
 
-Ready-to-use packages are available from the Percona Server for MySQL software
-repositories and the [Percona downloads] page.
+Percona provides ready-to-use packages for MySQL 8.4 through its APT repositories, offering seamless updates and dependency resolution for Debian-based systems.
 
 Specific information on the supported platforms, products, and versions is described in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
 
-We gather [Telemetry data] in the Percona packages and Docker images.
+Percona packages and Docker images collect anonymous telemetry data to improve product quality. For details on what is collected and how to opt out, see [Telemetry] in Percona Products.
 
 --8<--- "get-help-snip.md"
 
 ## ARM support
 
-The DEB builds for Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, DEBIAN 11, and DEBIAN 12 contain ARM packages with the `aarch64.rpm` extension. This means that Percona Server for MySQL is available for users on ARM-based systems.
+Percona Server for MySQL 8.4 supports ARM-based systems. DEB packages for Ubuntu 20.04, 22.04, 24.04 and Debian 11, 12 include ARM builds targeting the aarch64 architecture.
 
 ## Install Percona Server for MySQL using APT
 
 To install Percona Server for MySQL using APT, do the following steps:
 {.power-number}
 
-1. Update the package repositories:
+1. Update the package index:
 
 	```{.bash data-prompt="$"}
 	$ sudo apt update
@@ -36,29 +35,29 @@ To install Percona Server for MySQL using APT, do the following steps:
 	$ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
 	```
 
-4. Install the downloaded package with `apt` as root or with sudo:
+4. Install the package with `apt` as root or with sudo:
 
 	```{.bash data-prompt="$"}
 	$ sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
 	```
 
 
-5. Refresh the local cache to update the package information:
+5. Refresh the package index:
 
 	```{.bash data-prompt="$"}
 	$ sudo apt update
 	```
 
-6. Use `percona-release` to set up the repository for the Percona Server for MySQL {{vers}} version:
+6. Enable the Percona Server for MySQL {{vers}} repository:
 
 	```{.bash data-prompt="$"}
 	$ sudo percona-release enable-only {{pkg}} release
 	$ sudo percona-release enable tools release
 	```
 
-7. You can check the repository setup for the Percona original release list in `/etc/apt/sources.list.d/percona-original-release.list`. 
+7. [Optional] You can check the repository setup for the Percona original release list in `/etc/apt/sources.list.d/percona-original-release.list`. 
 
-8. Install the server package with the `percona-release` command:
+8. Install the server:
 
 	```{.bash data-prompt="$"}
 	$ sudo apt install percona-server-server
@@ -68,7 +67,7 @@ See [Configuring Percona repositories with `percona-release`](https://docs.perco
 
 --8<--- "storage-engines.md"
 
-Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These UDFs, `fnv_64`, `fnv1a_64`, `murmur_hash`, offer faster checksum calculations compared to standard methods. For detailed information about these user-defined functions, see [Percona Toolkit UDF functions](udf-percona-toolkit.md).
+Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/) for faster checksum calculations. Learn more in [Percona Toolkit UDF functions](udf-percona-toolkit.md).
 
 Once the installation completes, execute the following command to install these functions:
 
@@ -89,4 +88,4 @@ These builds should not be run in production. This build may not contain all of
 
 [Percona downloads]: https://www.percona.com/downloads/Percona-Server-{{vers}}/
 
-[Telemetry data]: telemetry.md
+[Telemetry]: telemetry.md