Merge branch '8.4' into pxc-4610

_resource/overrides/main.html

@@ -56,6 +56,9 @@
                   <div class="md-sidebar__inner">
                     {% include "partials/toc.html" %}
                   </div>
+                  <div class="md-sidebar__inner">
+                    {% include "partials/banner.html" %}
+                  </div>
                 </div>
               </div>
             {% endif %}

_resource/overrides/partials/banner.html

@@ -0,0 +1,9 @@
+<div data-banner="data-banner">
+    <p><svg style="display:block;margin:-1em 0 0.75em" width="78" height="69" viewBox="0 0 78 69" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M56.7281 30.7666C62.6528 26.8938 64.5914 18.9942 61.0059 12.7854C59.2094 9.67113 56.3053 7.44082 52.8311 6.50951C49.6122 5.64535 46.2502 5.99872 43.2912 7.49366L39.251 0.5L30.8648 15.0245L11.4811 48.5937H67.021L56.7281 30.7666ZM51.881 10.0674C54.4064 10.7401 56.5079 12.3616 57.8168 14.6194C60.3895 19.0701 59.053 24.7153 54.8808 27.5665L45.1362 10.6905C47.2355 9.68104 49.6034 9.46087 51.881 10.0674ZM39.251 7.87125L60.6339 44.907H48.1228L32.9927 18.7102L39.2499 7.87235L39.251 7.87125ZM17.8682 44.907L30.8637 22.4035L43.8592 44.907H17.8682Z" fill="url(#paint0_linear_2899_1968)"></path><path style="fill:var(--md-typeset-color)" d="M4.981 64.943H3.157V68.207H.756V57.323H5.217C7.822 57.323 9.397 58.861 9.397 61.086V61.116C9.397 63.635 7.433 64.94 4.984 64.94L4.981 64.943V64.943ZM6.961 61.134C6.961 60.061 6.213 59.485 5.011 59.485H3.154V62.812H5.056C6.258 62.812 6.958 62.096 6.958 61.163V61.134H6.961ZM10.738 68.208V57.323H18.973V59.455H13.124V61.664H18.27V63.796H13.124V66.082H19.051V68.214H10.738V68.208 68.208ZM27.557 68.208 25.218 64.726H23.332V68.208H20.931V57.323H25.921C28.496 57.323 30.039 58.677 30.039 60.915V60.945C30.039 62.702 29.088 63.807 27.7 64.32L30.367 68.207H27.556L27.557 68.208ZM27.605 61.041C27.605 60.016 26.887 59.485 25.719 59.485H23.333V62.61H25.767C26.936 62.61 27.605 61.987 27.605 61.071V61.042 61.041ZM36.922 68.499C33.668 68.499 31.249 65.994 31.249 62.825V62.795C31.249 59.659 33.619 57.091 37.019 57.091 39.105 57.091 40.356 57.783 41.383 58.792L39.834 60.571C38.98 59.798 38.113 59.327 37.004 59.327 35.141 59.327 33.795 60.871 33.795 62.762V62.793C33.795 64.684 35.107 66.257 37.004 66.257 38.268 66.257 39.043 65.753 39.913 64.964L41.462 66.524C40.322 67.738 39.059 68.493 36.925 68.493L36.922 68.499ZM47.885 68.499C44.47 68.499 42.021 65.962 42.021 62.825V62.795C42.021 59.659 44.503 57.091 47.915 57.091 51.327 57.091 53.779 59.628 53.779 62.765V62.795C53.779 65.931 51.297 68.499 47.885 68.499ZM51.237 62.795C51.237 60.904 49.846 59.331 47.885 59.331 45.925 59.331 44.567 60.874 44.567 62.766V62.796C44.567 64.688 45.959 66.261 47.919 66.261 49.879 66.261 51.237 64.717 51.237 62.826V62.795 62.795ZM67.001 68.217 72.374 57.091 77.746 68.218H75.052L72.374 62.681 69.705 68.218H67.001V68.217ZM66.007 57.327V68.5L57.813 61.884V68.199H55.264V57.091L63.458 63.681V57.327H66.007Z"></path><defs><linearGradient id="paint0_linear_2899_1968" x1="18.1513" y1="44.7152" x2="61.4356" y2="20.9786" gradientUnits="userSpaceOnUse"><stop stop-color="#FC3519"></stop><stop offset="1" stop-color="#F0D136"></stop></linearGradient></defs></svg></p>
+    <p>For help, click the link below to get free database assistance or contact our experts for personalized support.</p>
+
+    <div class="actions">
+
+    <a href="https://docs.percona.com/percona-xtradb-cluster/8.4/get-help.html" style="color: var(--md-typeset-a-color);">Get help from Percona</a>
+    </div>
+    </div>

docs/apt.md

@@ -1,4 +1,4 @@
-# Install Percona XtraDB Cluster on Debian or Ubuntu
+# Install on Debian or Ubuntu
 
 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).
@@ -10,6 +10,8 @@ using APT.
 
 We gather [Telemetry data] in the Percona packages and Docker images.
 
+--8<--- "get-help-snip.md"
+
 ## Prerequisites
 
 * You need to have root access on the node where you will be installing Percona XtraDB Cluster (either logged in as a user with root privileges or be able to run commands with sudo).
@@ -114,4 +116,4 @@ During the installation, you are requested to provide a password for the `root`
 After you install Percona XtraDB Cluster and stop the `mysql` service,
 configure the node according to the procedure described in [Configuring Nodes for Write-Set Replication](configure-nodes.md#configure).
 
-[Telemetry data]: telemetry.md
+[Telemetry data]: telemetry.md

docs/copyright-and-licensing-information.md

@@ -2,4 +2,4 @@
 
 ## Documentation licensing
 
-Percona XtraDB Cluster documentation is (C)2009-2023 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 XtraDB Cluster 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/).

docs/css/extra.css

@@ -4,4 +4,9 @@
       top: 0.6rem;
       left: 0.6rem;
     }
+  } 
+
+  .md-sidebar__inner {
+      font-size: 0.65rem;   /* Font size */
+      line-height: 1.6;
   }

docs/docker.md

@@ -9,14 +9,9 @@ provided via `apt` and `yum` may be outdated and cause errors.
 
 We gather [Telemetry data] in the Percona packages and Docker images.
 
-!!! note
+--8<--- "get-help-snip.md"
 
-    By default, Docker pulls the image from Docker Hub if the image is not
-    available locally.
-
-    The image contains only the most essential binaries for Percona XtraDB Cluster to
-    run. Some utilities included in a Percona Server for MySQL or MySQL
-    installation might be missing from the Percona XtraDB Cluster Docker image.
+By default, Docker pulls the image from Docker Hub if the image is not available locally. The image contains only the most essential Percona XtraDB Cluster binaries. Utilities included in a Percona Server for MySQL or MySQL installation might be missing from this image.
 
 The following procedure describes how to set up a simple 3-node cluster
 for evaluation and testing purposes. Do not use these instructions in a
@@ -25,6 +20,7 @@ procedure are self-signed. For a
 production environment, you should generate and store the certificates to be used by Docker.
 
 In this procedure, all of the nodes run Percona XtraDB Cluster {{vers}} in separate containers on one host:
+{.power-number}
 
 1. Create a ~/pxc-docker-test/config directory.
 
@@ -155,4 +151,4 @@ To verify the cluster is available, do the following:
         59 rows in set (0.02 sec)
         ```
 
-[Telemetry data]: telemetry.md
+[Telemetry data]: telemetry.md

docs/get-help.md

@@ -0,0 +1,24 @@
+# Get help from Percona
+
+Our documentation guides are packed with information, but they can’t cover everything you need to know about Percona XtraDB Cluster. They also won’t cover every scenario you might come across. Don’t be afraid to try things out and ask questions when you get stuck.
+
+## Percona's Community Forum
+
+Be a part of a space where you can tap into a wealth of knowledge from other database enthusiasts and experts who work with Percona’s software every day. While our service is entirely free, keep in mind that response times can vary depending on the complexity of the question. You are engaging with people who genuinely love solving database challenges.
+
+We recommend visiting our [Community Forum](https://forums.percona.com/t/welcome-to-perconas-community-forum/7){:target="_blank"}. It’s an excellent place for discussions, technical insights, and support around Percona database software. If you’re new and feeling a bit unsure, our [FAQ](https://forums.percona.com/faq){:target="_blank"} and [Guide for New Users](https://forums.percona.com/t/faq-guide-for-new-users/8562){:target="_blank"} ease you in.
+
+If you have thoughts, feedback, or ideas, the community team would like to hear from you at [Any ideas on how to make the forum better?](https://forums.percona.com/t/any-ideas-on-how-to-make-the-forum-better/11522){:target="blank"}. We’re always excited to connect and improve everyone's experience.
+
+## Percona experts
+
+[Percona experts](https://www.percona.com/services/consulting){:target="_blank"} bring years of experience in tackling tough database performance issues and design challenges. We understand your challenges when managing complex database environments. That's why we offer various services to help you simplify your operations and achieve your goals.
+
+| Service                    | Description                                                                                                                                                           |
+|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| 24/7 Expert Support        | Our dedicated team of database experts is available 24/7 to assist you with any database issues. We provide flexible support plans tailored to your specific needs.   |
+| Hands-On Database Management | Our managed services team can take over the day-to-day management of your database infrastructure, freeing up your time to focus on other priorities.               |
+| Expert Consulting          | Our experienced consultants provide guidance on database topics like architecture design, migration planning, performance optimization, and security best practices.  |
+| Comprehensive Training     | Our training programs help your team develop skills to manage databases effectively, offering virtual and in-person courses.                                          |
+
+We're here to help you every step of the way. Whether you need a quick fix or a long-term partnership, we're ready to provide your expertise and support.

docs/install-index.md

@@ -5,8 +5,9 @@ and ensure that you have root access to the MySQL server on each one.
 
 We gather [Telemetry data] in the Percona packages and Docker images.
 
-It is recommended to install Percona XtraDB Cluster from official Percona software repositories
-using the corresponding package manager for your system:
+--8<--- "get-help-snip.md"
+
+We recommended installing Percona XtraDB Cluster from official Percona software repositories using the appropriate package manager for your system:
 
 * [Debian or Ubuntu](apt.md#apt)
 
@@ -16,9 +17,9 @@ using the corresponding package manager for your system:
 
     After installing Percona XtraDB Cluster the ``mysql`` service is *stopped* but *enabled* so that it may start the next time the system is restarted. The service starts if the the grastate.dat file exists and the value of ``seqno`` is not **-1**.
 
-    !!! admonition "See also"
+    !!! admonition "For more information"
 
-        More information about Galera state information in [Index of files created by PXC grastat.dat](wsrep-files-index.md#wsrep-file-index)
+        See the Galera state information in [Index of files created by PXC grastat.dat](wsrep-files-index.md#wsrep-file-index)
 
 ## Installation alternatives