PS-11433 [DOCS] Configure Link inspector to process links with variables {{vers}} (9.7)

.github/workflows/linkspector.yml

@@ -0,0 +1,23 @@
+name: Linkspector
+on: 
+  pull_request:
+    paths:
+      - "docs/**"
+
+jobs:
+  check-links:
+    name: linkspector
+    runs-on: ubuntu-22.04
+    if: ${{ github.actor != 'dependabot[bot]' }}
+    steps:
+      - name: Check out code
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - name: Run linkspector
+        uses: umbrelladocs/action-linkspector@de84085e0f51452a470558693d7d308fbb2fa261 # v1.2.5
+        with:
+          github_token: ${{ secrets.ROBOT_TOKEN || secrets.GITHUB_TOKEN }}
+          reporter: github-pr-review
+          fail_level: error
+          filter_mode: nofilter
+          config_file: docs/.linkspector.yml

docs/.linkspector.yml

@@ -0,0 +1,21 @@
+dirs:
+  - docs
+
+ignorePatterns:
+  - pattern: "^https://www.reddit.com/r/VictoriaMetrics/"
+  - pattern: "^https://linux.die.net/man/8/logrotate"
+  - pattern: "#os_alerts$"
+  - pattern: "#pmm_alerts$"
+  - pattern: "#mongodb_alerts$"
+  - pattern: "#pbm_alerts$"
+  - pattern: "#mysql_alerts$"
+  - pattern: "#postgresql_alerts$"
+  - pattern: "#proxysql_alerts$"
+  - pattern: "^https://www\\.zmanda\\.com/zrm-community/?$"
+  - pattern: "^https://www\\.gnu\\.org/licenses/old-licenses/gpl-2\\.0\\.html/?$"
+  - pattern: "^https://www\\.hashicorp\\.com/en/products/vault/?$"
+
+replacementPatterns:
+  - pattern: "\\{\\{vers\\}\\}"
+    replacement: "9.7"
+

docs/data-at-rest-encryption.md

@@ -39,4 +39,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 :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/innovation-release/release-notes/release-notes.html) for more information.
+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/{{vers}}/release-notes/release-notes.html) for more information.

docs/downgrade.md

@@ -51,12 +51,12 @@ Downgrading has the following risks:
 ## Further reading
 
 * [Upgrade overview](./upgrade.md)
-* [Upgrade checklist for {{vers}}](./upgrade-checklist-8.4.md)
+* [Upgrade checklist for {{vers}}](./upgrade-checklist-9.7.md)
 * [Upgrade procedures for {{vers}}](./upgrade-procedures.md)
 * [Upgrade strategies](./upgrade-strategies.md)
 * [MySQL upgrade paths and supported methods](./mysql-upgrade-paths.md)
 * [Upgrade from plugins to components](./upgrade-components.md)
-* [Breaking and incompatible changes in {{vers}}](./8.4-breaking-changes.md)
-* [Compatibility and removed items in {{vers}}](./8.4-compatibility-and-removed-items.md)
-* [Defaults and tuning guidance for {{vers}}](./8.4-defaults-and-tuning.md)
-* [Percona Toolkit updates for {{vers}}](./percona-toolkit-8.4-updates.md)
+* [Breaking and incompatible changes in {{vers}}](./9.7-breaking-changes.md)
+* [Compatibility and removed items in {{vers}}](./9.7-compatibility-and-removed-items.md)
+* [Defaults and tuning guidance for {{vers}}](./9.7-defaults-and-tuning.md)
+* [Percona Toolkit updates for {{vers}}](./percona-toolkit-9.7-updates.md)

docs/download-instructions.md

@@ -2,28 +2,22 @@
 
 ## Select the software
 
-<!-- Update the following instruction to be valid for 9.7-->
-
 Do the following steps to select the software:
 
 1. Open [Percona Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads)
-2. Locate the Percona Software, for example, Percona Server for MySQL
-3. In `Select Product`, select the which product, for example, Percona Server {{vers}}
-4. In `Select Product Version`, select the version, for example, PERCONA-SERVER-{{release}}
-5. In `Select Platform`, select the operating system, for example, DEBIAN GNU/LINUX 12.0 ("BOOKWORM").
-
-The easiest method is to download all packages. 
+2. Select a product, for example, Percona Server for MySQL
+3. In `Product Group`, select which product, for example, Percona Server {{vers}}
+4. In `Version`, select the version, for example, PERCONA-SERVER-{{release}}
+5. In `Platform`, select the operating system, for example, DEBIAN GNU/LINUX 12.0 ("BOOKWORM").
 
 The `Package Download Options` may mix `amd64` and `arm64` packages. Select the correct CPU architecture for your system.
 
 ## Download to a local computer
 
- In `Package Download Options`, select a specific package or select the `DOWNLOAD ALL PACKAGES` button.
-
-The selected packages are downloaded to the local computer.
+In `Package Download Options`, select a specific package and click `Download`. This action downloads the selected packages to the local computer.
 
 ## Download to another computer
 
-In `Package Download Options`, select a specific package or select the `DOWNLOAD ALL PACKAGES` button, and hover your cursor over the `DOWNLOAD` arrow. Right-click and in the drop-down menu, select `Copy Link`.
+In `Package Download Options`, select a specific package and right-click on the `DOWNLOAD`, and in the drop-down menu, choose `Copy Link Address`
 
 Paste the link in your terminal to download the selected package.

docs/fips.md

@@ -4,12 +4,6 @@ The Federal Information Processing Standards (FIPS) are a set of regulations man
 
 Percona Server for MySQL can run in FIPS mode if a FIPS-enabled OpenSSL library and FIPS Object Module are available at runtime or if compiled using a FIPS-validated version of OpenSSL. FIPS mode remains off by default and must be enabled via [OS/OpenSSL configuration](#prerequisites). 
 
-## Version changes
-
-Introduced in Percona Server for MySQL Pro build for [8.4.0-1](release-notes/8.4.0-1.md). You can also receive this functionality by [building Percona Server for MySQL from source code](compile-percona-server.md).
-
-[Percona Server for MySQL 8.4.0-5](release-notes/8.4.7-7.md) includes the FIPS-capable binaries in all builds. No Pro build is required for FIPS compatibility. 
-
 ## Prerequisites
 
 To prepare Percona Server for MySQL for FIPS certification, do the following:

docs/group-replication-flow-control.md

@@ -12,7 +12,7 @@ Flow controls work asynchronously and depend on the following:
 The following system variables set flow control behavior for Group Replication:
 
 * [group_replication_flow_control_mode :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/group-replication-options.html#sysvar_group_replication_flow_control_mode)
-* [group_replication_flow_control_certifier_threshold :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/group-replication-options)
+* [group_replication_flow_control_certifier_threshold :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/group-replication-system-variables.html#sysvar_group_replication_flow_control_certifier_threshold)
 * [group_replication_flow_control_applier_threshold :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/group-replication-options.html#sysvar_group_replication_flow_control_applier_threshold)
 
 Flow control is enabled and disabled by selecting a value in the group_replication_flow_control_mode variable. Flow control can also be enabled on the certifier or applier level or both and sets the threshold level.