DISTMYSQL-575 [DOCS] Create new 9.7 branch based on 8.4 and update the docs

	modified:   README.md
	modified:   _resource/overrides/main.html
	modified:   _resource/overrides/partials/banner.html
	modified:   _resourcepdf/overrides/partials/banner.html
	modified:   _resourcepdf/overrides/partials/edit.html
	modified:   docs/components.md
	modified:   docs/deployment-variants.md
	modified:   docs/downgrade.md
	modified:   docs/download-instructions.md
	modified:   docs/index.md
	modified:   docs/install-pdps.md
	modified:   docs/install-pdpxc.md
	modified:   docs/installing.md
	modified:   docs/minor-upgrade.md
	modified:   docs/monitoring.md
	modified:   docs/pdps-group-replication.md
	modified:   docs/ps-or-pdps.md
	deleted:    docs/release-notes-ps-8.4.1.md
	deleted:    docs/release-notes-ps-8.4.2.md
	deleted:    docs/release-notes-ps-8.4.3.md
	deleted:    docs/release-notes-ps-8.4.4.md
	deleted:    docs/release-notes-ps-8.4.5.md
	deleted:    docs/release-notes-ps-8.4.6.md
	deleted:    docs/release-notes-ps-8.4.7.md
	deleted:    docs/release-notes-ps-8.4.md
	deleted:    docs/release-notes-pxc-8.4.0.md
	deleted:    docs/release-notes-pxc-8.4.2.md
	deleted:    docs/release-notes-pxc-8.4.3.md
	deleted:    docs/release-notes-pxc-8.4.4.md
	deleted:    docs/release-notes-pxc-8.4.5.md
	deleted:    docs/release-notes-pxc-8.4.6.md
	deleted:    docs/release-notes-pxc-8.4.7.md
	modified:   docs/release-notes.md
	modified:   docs/templates/pdf_cover_page.tpl
	modified:   docs/uninstalling.md
	modified:   mkdocs-base.yml
	modified:   mkdocs.yml
	modified:   variables.yml

Author: alina-derkach-oaza

README.md

@@ -21,7 +21,7 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona
 |MySQL Router       |YES                        |NO                    |
 
 
-This repository contains the source files for [Percona Distribution for MySQL documentation](https://www.percona.com/doc/percona-distribution-mysql/8.0/index.html). The documentation is written in [reStructured text markup language](https://docutils.sourceforge.io/rst.html) and is created using [Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/). 
+This repository contains the source files for [Percona Distribution for MySQL documentation](https://docs.percona.com/percona-distribution-for-mysql/8.0/). The documentation is written in [reStructured text markup language](https://docutils.sourceforge.io/rst.html) and is created using [Sphinx Python Documentation Generator](https://www.sphinx-doc.org/en/master/). 
 
 ## Contributing
 

_resource/overrides/main.html

@@ -17,8 +17,8 @@
                  {% endif %}
                  <meta property="og:type" content="website" />
                  <meta property="og:title" content="{{ title }}" />
-                 <meta property="og:url" content="https://docs.percona.com/percona-distribution-for-mysql/innovation-release/" />
-                 <meta property="og:image" content="https://docs.percona.com/percona-distribution-for-mysql/innovation-release/_images/percona-mysql-logo.png" />
+                 <meta property="og:url" content="https://docs.percona.com/percona-distribution-for-mysql/9.7/" />
+                 <meta property="og:image" content="https://docs.percona.com/percona-distribution-for-mysql/9.7/_images/percona-mysql-logo.png" />
                {% endblock %}
 
                {% block site_nav %}
@@ -32,7 +32,7 @@
                        {% include "partials/nav.html" %}
                        <br>
                        <label class="md-nav__title" for="__drawer">
-       <a href="https://learn.percona.com/download-manual-percona-distribution-for-mysql-innovation-releases" onclick="_gaq.push(['b._trackEvent', 'Percona Distribution for MySQL', 'Download', 'Download Manual Distribution for MySQL']);" class="md-nav__link md-nav__link--active" style="font-size: .7rem;">
+       <a href="https://learn.percona.com/download-manual-percona-distribution-for-mysql-9.7" onclick="_gaq.push(['b._trackEvent', 'Percona Distribution for MySQL', 'Download', 'Download Manual Distribution for MySQL']);" class="md-nav__link md-nav__link--active" style="font-size: .7rem;">
          Download PDF
        </a>
      </label> 

_resource/overrides/partials/banner.html

@@ -4,6 +4,6 @@
 
     <div class="actions">
 
-    <a href="https://docs.percona.com/percona-distribution-for-mysql/8.4/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
+    <a href="https://docs.percona.com/percona-distribution-for-mysql/9.7/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
     </div>
     </div>

_resourcepdf/overrides/partials/banner.html

@@ -4,6 +4,6 @@
 
     <div class="actions">
 
-    <a href="https://docs.percona.com/percona-distribution-for-mysql/8.4/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
+    <a href="https://docs.percona.com/percona-distribution-for-mysql/9.7/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
     </div>
     </div>

_resourcepdf/overrides/partials/edit.html

@@ -13,7 +13,7 @@
     <div class="banner-divider"></div>
 
     <!-- Contributing Guide below, smaller -->
-    <a href="https://github.com/percona/pdmysql-docs/blob/8.4/CONTRIBUTING.md"
+    <a href="https://github.com/percona/pdmysql-docs/blob/9.7/CONTRIBUTING.md"
        title="Contributing guide"
        class="contrib-link"
        target="_blank"

docs/components.md

@@ -4,9 +4,9 @@ Percona Distribution for MySQL consists of the following **components**:
 
 * [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/) is a drop-in replacement for MySQL Community Edition with the enterprise-grade features embedded by Percona.
 
-* [Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/{{vers}}/index.html) is the high-available clustering solution for MySQL. It is based on [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/index.html) and uses [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/index.html) for node provisioning.
+* [Percona XtraDB Cluster :octicons-link-external-16:](https://docs.percona.com/percona-xtradb-cluster/8.4/index.html) is the high-available clustering solution for MySQL. It is based on [Percona Server for MySQL :octicons-link-external-16:](https://docs.percona.com/percona-server/{{vers}}/index.html) and uses [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/8.4/index.html) for node provisioning.
 
-* [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/) is an open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.
+* [Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/8.4/) is an open-source hot backup utility for MySQL-based servers that doesn’t lock your database during the backup.
 
 * [Orchestrator :octicons-link-external-16:(https://github.com/openark/orchestrator) is the replication topology manager for Percona Server for MySQL.
 
@@ -21,8 +21,10 @@ Percona Distribution for MySQL consists of the following **components**:
 
 * [MySQL Router :octicons-link-external-16:](https://dev.mysql.com/doc/mysql-router/{{vers}}/en/) is lightweight middleware that provides transparent routing between your application and back-end MySQL servers.
 
+<!-- Clarify whether the following note is valid for 9.7-->
+
 !!! important
 
-    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL 8.4 becomes available.
+    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.
 
-    ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
+    In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures.

docs/deployment-variants.md

@@ -12,11 +12,13 @@ Percona Distribution for MySQL provides two deployment variants: one is Percona
 | MySQL Shell  | YES                        |
 | MySQL Router | YES                        |
 
+<!-- Clarify whether the following note is valid for 9.7-->
+
 !!! important
 
-    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL 8.4 becomes available.
+    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.
 
-    ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
+    In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures.
 
 ## What deployment variant to choose?
 

docs/downgrade.md

@@ -1,14 +1,16 @@
 # Downgrade Percona Distribution for MySQL
 
+<!-- Clarify whether the following note is valid for 9.7-->
+
 !!! important
 
-    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL 8.4 becomes available.
+    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.
 
-    ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
+    In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures.
 
 You have the following downgrade options:
 
-1. Within Same LTS Version (Example: 8.4.5 to 8.4.3):
+1. Within Same LTS Version (Example: 9.7.3 to 9.7.1):
 
     * Methods Available:
 
@@ -20,17 +22,7 @@ You have the following downgrade options:
 
     * Replication-based downgrade
 
-2. From LTS to Previous LTS (Example: 8.4.x to 8.0.y):
-
-    * Methods Available:
-    
-      * Logical dump and restore
-      
-      * Replication-based downgrade
-      
-    * Important: Only works for rollback if you haven't used new features
-
-3. From LTS to Innovation Release (Example: 8.4.x to 8.3.0):
+2. From LTS to Previous LTS (Example: 9.7.x to 8.4.y):
 
     * Methods Available:
 

docs/download-instructions.md

@@ -5,7 +5,7 @@ Do the following steps to select the software, the software version, and downloa
 1. Go to [Percona Software Downloads :octicons-link-external-16:](https://www.percona.com/downloads).
 2. Locate Percona Distribution for MySQL.
 3. Select the required product in `Select Product`, for example, Percona Server for MySQL.
-4. Select your distribution version in the `Select Product Version` dropdown, for example, `percona-distribution-mysql-ps-8.4.4`.
+4. Select your distribution version in the `Select Product Version` dropdown, for example, `percona-distribution-mysql-ps-9.7.1`.
 5. Select your platform in the `Select Platform` dropdown, for example, `Ubuntu 24.04 (Noble Numbat)`.
 
 The `Package Download Options` may include both `AMD64` and `ARM64` packages. Select the correct CPU architecture for your system.

docs/index.md

@@ -14,11 +14,13 @@ Percona Distribution for MySQL is a single solution with the best and most criti
 
 Percona Distribution for MySQL comes in two [deployment variants](deployment-variants.md): one is based on Percona Server for MySQL and another one - on Percona XtraDB Cluster. They differ in the set of components and how you can use them. 
 
+<!-- Clarify whether the following note is valid for 9.7-->
+
 !!! important
 
-    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL 8.4 becomes available.
+    This release does not include the Percona Toolkit component. We will add it once a Percona Toolkit version compatible with MySQL {{vers}} becomes available.
 
-    ProxySQL contains counters that have not been updated to use the new terminology. Unexpected results may occur. In an 8.4.x environment, the binlog reader errors out during initialization due to the use of old terminology, such as the SHOW MASTER STATUS command.
+    In {{vers}}.x environments, the ProxySQL binlog reader can fail to initialize because it uses legacy commands, such as SHOW MASTER STATUS. Some internal counters also use outdated terminology. To address most terminology issues, enable the [terminology_use_previous](https://dev.mysql.com/doc/refman/{{vers}}/en/replication-options-replica.html#sysvar_terminology_use_previous) system variable on the database server. This workaround addresses only terminology compatibility and may not fix all failures.
 
 <div data-grid markdown><div data-banner markdown>