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,44 @@
 # 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:
+To pin the Percona Server for MySQL 8.4 packages, follow these steps:
+{.power-number}
 
-```text
-Package: 
-Pin: release o=Percona Development Team
-Pin-Priority: 1001
-```
+1.  Create a preferences file in `/etc/apt/preferences.d/` named `00percona.pref`:
 
-For more information about the pinning, you can check the official [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
+    ```{.bash data-prompt="$"}
+    $ sudo nano /etc/apt/preferences.d/00percona.pref
+    ```
+
+2.  Add the pinning configuration content to the file:
+
+    ```ini
+    Package: percona-server-server
+    Pin: release o=Percona Development Team,a=stable
+    Pin-Priority: 1001
+    ```
+
+    * 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.
+
+3.  Update package lists to refresh your package sources:
+
+    ```{.bash data-prompt="$"}
+    $ sudo apt update
+    ```
+
+4.  Install Percona Server for MySQL 8.4 using the following command:
+
+    ```{.bash data-prompt="$"}
+    $ sudo apt install percona-server-server
+    ```
+
+    Your system prioritizes the version from the Percona repository 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,64 +1,59 @@
-# 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 Percona Server 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).
+If you need help with installation or configuration, [Percona Support](https://www.percona.com/services/support) is available to assist you.
+
+Specific information on the supported platforms, products, and versions are available in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
+
+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 Server for MySQL].
 
-We gather [Telemetry data] in the Percona packages and Docker images.
 
---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 includes native support for the ARM64 (aarch64) architecture in its DEB packages. These packages are available for Ubuntu starting with version 20.04 and for Debian starting with version 11.
+
 
 ## 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 and install `curl`:
 
 	```{.bash data-prompt="$"}
-	$ sudo apt update
+	$ sudo apt update && sudo apt install curl
 	```
 
-2. Install the `curl` download utility if needed:
-
-	```{.bash data-prompt="$"}
-	$ sudo apt install curl
-	```
-	
-3. Download the `percona-release` repository package:
+2. Download the `percona-release` repository package:
 
 	```{.bash data-prompt="$"}
 	$ 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:
+3. 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:
+4. 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:
+5. 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`. 
+6. [Optional] You can check the repository setup for the Percona original release list in ```cat /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 +63,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 +84,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 in Percona Server for MySQL]: telemetry.md