percona · alina-derkach-oaza · Dec 22, 2025 · Dec 8, 2025 · Dec 9, 2025 · Dec 8, 2025
diff --git a/docs/8.4-breaking-changes.md b/docs/8.4-breaking-changes.md
@@ -2,7 +2,7 @@
 
 Review these items before upgrading from 8.0 to {{vers}}. This document covers the most significant breaking behavioral changes, removed features, and removed variables that may affect your upgrade. Each entry includes the impact, replacement (if available), and recommended action.
 
-Review the [MySQL 8.4 Reference manual](https://dev.mysql.com/doc/refman/8.4/en/) for more information.
+Review the [MySQL 8.4 Reference manual :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.4/en/) for more information.
 
 ## Authentication and user management
 

diff --git a/docs/adaptive-network-buffers.md b/docs/adaptive-network-buffers.md
@@ -2,7 +2,7 @@
 
 To find the buffer size of the current connection, use the `network_buffer_length` status variable. Add `SHOW GLOBAL` to review the cumulative buffer sizes for all connections. This variable can help to estimate the maximum size of the network buffer’s overhead.
 
-Network buffers grow towards the [max_allowed_packet] size and do not shrink until the connection is terminated. For example, if the connections are selected at random from the pool, an occasional big query eventually increases the buffers of all connections. The combination of max_allowed packet set to a value between 64MB and 128MB and the connection number between 256 and 1024 can create a large memory overhead.
+Network buffers grow towards the [max_allowed_packet :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-variables.html#sysvar_max_allowed_packet) size and do not shrink until the connection is terminated. For example, if the connections are selected at random from the pool, an occasional big query eventually increases the buffers of all connections. The combination of max_allowed packet set to a value between 64MB and 128MB and the connection number between 256 and 1024 can create a large memory overhead.
 
 Percona Server for MySQL implemented the [net_buffer_shrink_interval](#net_buffer_shrink_interval) variable to solve this issue. The default value is 0 (zero). If you set the value higher than 0, Percona Server records the network buffer’s maximum use size for the number of seconds set by net_buffer_shrink_interval. When the next interval starts, the network buffer is set to the recorded size. This action removes spikes in the buffer size.
 
@@ -19,5 +19,3 @@ You can achieve similar results by disconnecting and reconnecting the TCP connec
 | Default value: | 0                             |
 
 The interval is measured in seconds. The default value is 0, which disables the functionality. The minimum value is 0, and the maximum value is 31536000.
-
-[max_allowed_packet]: https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-variables.html#sysvar_max_allowed_packet
diff --git a/docs/advisors.md b/docs/advisors.md
@@ -1,7 +1,6 @@
 # Use Percona Monitoring and Management (PMM) Advisors
 
-[Percona Monitoring and Management (PMM)](https://www.percona.com/software/database-
-tools/percona-monitoring-and-management) provides several categories of Advisors. 
+[Percona Monitoring and Management (PMM) :octicons-link-external-16:](https://www.percona.com/software/database-tools/percona-monitoring-and-management) provides several categories of Advisors. 
 Each Advisor contains a set of automated checks. These checks investigate your 
 database settings for a specific range of possible issues.
 
@@ -11,10 +10,9 @@ Both options are enabled by default.
 
 !!! note "Need Additional Guidance?"
     If you encounter complex advisor recommendations or require expert 
-    interpretation, [Percona Support](https://www.percona.com/services/support) 
+    interpretation, [Percona Support :octicons-link-external-16:](https://www.percona.com/services/support) 
     offers professional assistance to help you optimize your database 
     configuration and resolve any identified issues.
 
 !!! admonition "See also"
-    [PMM documentation - Advisor checks](https://docs.percona.com/percona-platform/
-    advisors.html)
+    [PMM documentation - Advisor checks :octicons-link-external-16:](https://docs.percona.com/percona-monitoring-and-management/3/advisors/advisors.html)
diff --git a/docs/aio-page-requests.md b/docs/aio-page-requests.md
@@ -4,12 +4,11 @@ The I/O unit size in *InnoDB* is only one page, even if the server doing read ah
 I/O unit size is too small for sequential reads, and less efficient than a larger I/O unit size. *InnoDB* uses Linux asynchronous I/O (`aio`) by default. By submitting multiple, consecutive 16KB read requests at the same time, Linux internally merges the requests and
 reads more efficiently. 
 
-This feature is able to submit multiple page I/O requests and works in the background. You can manage the feature with the [linear read-ahead technique]. This technique adds pages to the buffer pool based on the buffer pool pages being accessed sequentially. The [`innodb_read_ahead_threshold`] configuration parameter controls this operation.
+This feature is able to submit multiple page I/O requests and works in the background. You can manage the feature with the [linear read-ahead technique]. This technique adds pages to the buffer pool based on the buffer pool pages being accessed sequentially. The [`innodb_read_ahead_threshold`](https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold) configuration parameter controls this operation.
 
-[On a HDD RAID 1+0 environment](http://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html),
+[On a HDD RAID 1+0 environment :octicons-link-external-16:](http://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html),
 more than 1000MB/s disk reads can be achieved by submitting 64 consecutive pages
-requests at once, while only
-160MB/s disk reads is shown by submitting single page request.
+requests at once, while only 160MB/s disk reads is shown by submitting single page request.
 
 ## Status variables
 
@@ -24,10 +23,6 @@ This variable shows the number of submitted buffered asynchronous I/O requests.
 
 ## Other reading
 
-* [Making full table scan 10x faster in InnoDB](https://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html)
+* [Making full table scan 10x faster in InnoDB :octicons-link-external-16:](https://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html)
 
-* [Bug #68659  InnoDB Linux native aio should submit more i/o requests at once](https://bugs.mysql.com/bug.php?id=68659)
-
-[linear read-ahead technique]: https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-performance-read_ahead.html
-
-[`innodb_read_ahead_threshold`]: https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold 
+* [Bug #68659  InnoDB Linux native aio should submit more i/o requests at once :octicons-link-external-16:](https://bugs.mysql.com/bug.php?id=68659)
diff --git a/docs/apt-download-deb.md b/docs/apt-download-deb.md
@@ -1,6 +1,6 @@
 # Install Percona Server for MySQL {{vers}} using downloaded DEB packages
 
-Download the packages from [Percona Product Downloads](https://www.percona.com/downloads). If needed, [Instructions for the Percona Product Download](download-instructions.md) are available.
+Download the packages from [Percona Product Downloads :octicons-link-external-16:](https://www.percona.com/downloads). If needed, [Instructions for the Percona Product Download](download-instructions.md) are available.
 
 The following example downloads Percona Server for MySQL {{release}} release packages for Ubuntu 22.04:
 

diff --git a/docs/apt-pinning.md b/docs/apt-pinning.md
@@ -12,4 +12,4 @@ Pin: release o=Percona Development Team
 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).
+For more information about the pinning, you can check the official [debian wiki :octicons-link-external-16:](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
diff --git a/docs/apt-repo.md b/docs/apt-repo.md
@@ -1,8 +1,8 @@
 # Use an APT repository to install Percona Server for MySQL {{vers}}
 
-Ready-to-use packages are available from the Percona Server for MySQL software repositories and the [Percona downloads] page.
+Ready-to-use packages are available from the Percona Server for MySQL software repositories and the [Percona downloads :octicons-link-external-16:](https://www.percona.com/downloads/Percona-Server-{{vers}}/) page.
 
-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).
+Specific information on the supported platforms, products, and versions is described in [Percona Software and Platform Lifecycle :octicons-link-external-16:](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
 
 --8<-- "percona-release.md"
 
@@ -272,7 +272,7 @@ To install Percona Server for MySQL using APT, follow these steps:
 
 	* Review error messages for specific issues
 
-See [Configuring Percona repositories with `percona-release`](https://docs.percona.com/percona-software-repositories/percona-release.html) for more information.
+See [Configuring Percona repositories with `percona-release` :octicons-link-external-16:](https://docs.percona.com/percona-software-repositories/percona-release.html) for more information.
 
 --8<--- "storage-engines.md"
 
@@ -282,7 +282,7 @@ After successful installation, see [Post-installation](post-installation.md) for
 
 ## Install Percona Toolkit UDFs (Optional)
 
-Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These UDFs provide faster checksum calculations:
+Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit :octicons-link-external-16:](https://docs.percona.com/percona-toolkit/). These UDFs provide faster checksum calculations:
 
 * `fnv_64`: Fast hash function
 
@@ -377,6 +377,4 @@ $ sudo apt update
 	All packages are up to date.
 	```
 
-[Percona downloads]: https://www.percona.com/downloads/Percona-Server-{{vers}}/
-
 [Telemetry data]: telemetry.md
diff --git a/docs/audit-log-filter-variables.md b/docs/audit-log-filter-variables.md
@@ -676,7 +676,7 @@ This read-only variable specifies the syslog tag value. This variable requires a
 | Data type | String  |
 | Default | LOG_USER |
 
-This read-only variable specifies the syslog `facility` value. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
+This read-only variable specifies the syslog `facility` value. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).
 
 
 ### `audit_log_filter.syslog_priority`
@@ -689,7 +689,7 @@ This read-only variable specifies the syslog `facility` value. This variable req
 | Data type | String  |
 | Default | LOG_INFO |
 
-This read-only variable defines the `priority` value for the syslog. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
+This read-only variable defines the `priority` value for the syslog. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).
 
 ## Audit log filter status variables
 

diff --git a/docs/backup-restore-overview.md b/docs/backup-restore-overview.md
@@ -52,7 +52,7 @@ A backup can be either a physical backup or a logical backup.
 A physical backup copies the files needed to store and recover the database. They can be data files, configuration files,
 logs, and other types of files. The physical database can be stored in the cloud, in offline storage, on disc, or tape.
 
-[Percona XtraBackup] takes a physical backup. You can also 
+[Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/index.html) takes a physical backup. You can also 
 use RDS/LVM Snapshots or the MySQL Enterprise Backup. 
 
 If the server is stopped or down, you can copy the datadir with the `cp` command or the `rsync` command.
@@ -61,10 +61,10 @@ If the server is stopped or down, you can copy the datadir with the `cp` command
 
 A logical backup contains the structural details. This type of backup contains tables, views, procedures, and functions. 
 
-Tools like [`mysqldump`], 
-[`mydumper`], 
-[`mysqlpump`], and 
-[`mysql shell`] take a logical backup.
+Tools like [`mysqldump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/mysqldump.html), 
+[`mydumper` :octicons-link-external-16:](https://github.com/mydumper/mydumper) 
+[`mysqlpump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/mysqlpump.html), and 
+[`mysql shell` :octicons-link-external-16:](https://dev.mysql.com/doc/mysql-shell/{{vers}}/en/mysql-shell-utilities-dump-instance-schema.html) take a logical backup.
 
 ### Comparison
 
@@ -73,9 +73,3 @@ Tools like [`mysqldump`],
 | Content        | The physical database files                       | The tables, users, procedures, and functions                  |
 | Restore speed  | Restore can be quick                              | Restore can be slower and does not include file information.  |
 | Storage        | Can take more space                               | Based on what is selected, the backup can be smaller          |
-
-[`mysqldump`]: https://dev.mysql.com/doc/refman/{{vers}}/en/mysqldump.html
-[`mydumper`]: https://github.com/mydumper/mydumper
-[`mysqlpump`]: https://dev.mysql.com/doc/refman/{{vers}}/en/mysqlpump.html
-[`mysql shell`]: https://dev.mysql.com/doc/mysql-shell/{{vers}}/en/mysql-shell-utilities-dump-instance-schema.html
-[Percona XtraBackup]: https://docs.percona.com/percona-xtrabackup/innovation-release/index.html
diff --git a/docs/binary-tarball-install.md b/docs/binary-tarball-install.md
@@ -4,13 +4,10 @@ A binary tarball contains a group of files, including the source code, bundled t
 
 See the list of the [binary tarball available based on the Percona Server for MySQL version](binary-tarball-names.md) to select the right tarball for your environment.
 
-You can download the binary tarballs from the `Linux - Generic` [section] on the download page.
+You can download the binary tarballs from the `Linux - Generic` [section :octicons-link-external-16:](https://www.percona.com/downloads/Percona-Server-{{vers}}/LATEST/binary/tarball/) on the download page.
 
 Fetch and extract the correct binary tarball. For example for Ubuntu 22.04:
 
 ```{.bash data-prompt="$"}
 $ wget https://downloads.percona.com/downloads/Percona-Server-innovative-release/Percona-Server-{{release}}/binary/tarball/Percona-Server-{{release}}-Linux.x86_64.glibc2.35.tar.gz
 ```
-
-[section]: https://www.percona.com/downloads/Percona-Server-{{vers}}/LATEST/binary/tarball/
-
diff --git a/docs/binlogging-replication-improvements.md b/docs/binlogging-replication-improvements.md
@@ -67,7 +67,7 @@ log regardless of the value of the binlog_skip_flush_command variable.
 any user (even by those with the `SUPER` privilege) are not written to the
 binary log regardless of the value of the binlog_skip_flush_commands variable.
 
-An attempt to run a `FLUSH` command without either [`SUPER`](https://dev.mysql.com/doc/refman/8.4/en/privileges-provided.html#priv_super) or [`RELOAD`](https://dev.mysql.com/doc/refman/8.4/en/privileges-provided.html#priv_reload)
+An attempt to run a `FLUSH` command without either [`SUPER`](https://dev.mysql.com/doc/refman/8.4/en/privileges-provided.html#priv_super :octicons-link-external-16:) or [`RELOAD`](https://dev.mysql.com/doc/refman/8.4/en/privileges-provided.html#priv_reload :octicons-link-external-16:)
 privileges results in the `ER_SPECIFIC_ACCESS_DENIED_ERROR` exception
 regardless of the value of the `binlog_skip_flush_commands` variable.
 
@@ -225,7 +225,7 @@ The `binlog_utils_udf` component provides six functions for binary log analysis
 
 * Binary log file names: Functions that accept a binary log name require only the short file name (for example, `binlog.000001`). Do not include the full path. If the input contains a path separator (`/`), the server returns an error.
 
-* Binary log directory: The server reads binary logs from the directory defined by the `@@log_bin_basename` system variable.
+* Binary log directory: The server reads binary logs from the directory defined by the [`@@log_bin_basename`](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#sysvar_log_bin_basename :octicons-link-external-16:) system variable.
 
 * Return values: Functions that return binary log file names return only the short name without the path.
 
@@ -402,14 +402,8 @@ The query should return no rows if the component is successfully uninstalled.
 
 For the following variables, do not define values with one or more dot (.) characters:
 
-* [log_bin]
+* [log_bin :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#option_mysqld_log-bin)
 
-* [log_bin_index]
+* [log_bin_index :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#option_mysqld_log-bin-index)
 
 A value defined with the dot (.) character is handled differently in MySQL and Percona XtraBackup and can cause unpredictable behavior.
-
-[@@log_bin_basename system variable]: https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#sysvar_log_bin_basename
-
-[log_bin]: https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#option_mysqld_log-bin
-
-[log_bin_index]: https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-binary-log.html#option_mysqld_log-bin-index
diff --git a/docs/compile-percona-server.md b/docs/compile-percona-server.md
@@ -4,7 +4,7 @@ The following instructions install Percona Server for MySQL {{vers}}.
 
 ## Install Percona Server for MySQL from the Git Source Tree
 
-Percona uses the [Github](https://github.com/) revision
+Percona uses the [Github :octicons-link-external-16:](https://github.com/) revision
 control system for development. To build the latest Percona Server for MySQL
 from the source tree, you will need `git` installed on your system.
 

diff --git a/docs/copyright-and-licensing-information.md b/docs/copyright-and-licensing-information.md
@@ -2,7 +2,7 @@
 
 ## Documentation licensing
 
-Percona Server for MySQL documentation is (C)2009-2025 Percona LLC and/or its affiliates and is distributed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
+Percona Server for MySQL documentation is (C)2009-2025 Percona LLC and/or its affiliates and is distributed under the [Creative Commons Attribution 4.0 International License :octicons-link-external-16:](https://creativecommons.org/licenses/by/4.0/).
 
 ## Software license
 

diff --git a/docs/data-at-rest-encryption.md b/docs/data-at-rest-encryption.md
@@ -40,6 +40,4 @@ layer, added to the buffer pool, and used to access the data. A buffer pool page
 
 Percona XtraBackup version {{vers}} supports the backup of encrypted general tablespaces. 
 
-Percona XtraBackup only supports features that are [Generally Available (GA)](glossary.md#general-availability-ga) in Percona Server for MySQL. Due to time constraints, a GA feature may be supported in a later Percona XtraBackup release. Review the [Percona XtraBackup release notes] for more information.
-
-[Percona XtraBackup release notes]: https://docs.percona.com/percona-xtrabackup/innovation-release/release-notes/release-notes.html
+Percona XtraBackup only supports features that are [Generally Available (GA)](glossary.md#general-availability-ga) in Percona Server for MySQL. Due to time constraints, a GA feature may be supported in a later Percona XtraBackup release. Review the [Percona XtraBackup release notes :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/innovation-release/release-notes/release-notes.html) for more information.