Release notes reorganization improvements 17 (#829)

Andriciuc · web-flow · commit 5a9bb7998efb · 2025-07-23T13:41:13.000+03:00
* move release notes to folder, fix links in rns, reorganize ToC and RN index

* Update index.md

* fix variable issue in release-notes.md

* update the versions in ToC to correct ver nr

* fix link to rns in index and remove empty space
diff --git a/docs/index.md b/docs/index.md
@@ -48,11 +48,6 @@ Our comprehensive resources will help you overcome challenges, from everyday iss
 
 Learn about the releases and changes in the Distribution.
 
-[Release notes :material-arrow-right:]({{release}}.md){.md-button}
+[Release notes :material-arrow-right:](release-notes/{{release}}.md){.md-button}
 </div>
 </div>
-
-
-
-
-
diff --git a/docs/release-notes.md b/docs/release-notes.md
diff --git a/docs/release-notes/release-notes-v17.0.md b/docs/release-notes/release-notes-v17.0.md
@@ -1,16 +1,15 @@
 # Percona Distribution for PostgreSQL 17.0.1 ({{date.17_0}})
 
-[Installation](installing.md){.md-button}
-[Upgrade](major-upgrade.md){.md-button}
- 
+[Installation](../installing.md){.md-button}
+[Upgrade](../major-upgrade.md){.md-button}
 
 We are pleased to announce the launch of Percona Distribution for PostgreSQL 17.0.1 - a solution with the collection of tools from PostgreSQL community that are tested to work together and serve to assist you in deploying and managing PostgreSQL. The aim of Percona Distribution for PostgreSQL is to address the operational issues like High-Availability, Disaster Recovery, Security, Observability, Spatial data handling, Performance and Scalability and others that enterprises are facing.
 
-This release of Percona Distribution for PostgreSQL is based on **Percona Server for PostgreSQL 17.0.1** - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.0 :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17.html). 
+This release of Percona Distribution for PostgreSQL is based on **Percona Server for PostgreSQL 17.0.1** - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.0 :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17.html).
 
-Both Percona Server for PostgreSQL and PostgreSQL Community function identically enabling you to migrate from one to another. 
+Both Percona Server for PostgreSQL and PostgreSQL Community function identically enabling you to migrate from one to another.
 
-Percona Server for PostgreSQL 17.0.1 has the extra digit in version which represents Percona version number. 
+Percona Server for PostgreSQL 17.0.1 has the extra digit in version which represents Percona version number.
 
 To check what software you're running, run the following SQL query:
 
@@ -70,7 +69,7 @@ This feature is especially beneficial for organizations with large data sets whe
 
 #### Replication improvements
 
-* Gain more control for managing PostgreSQL databases in high availability environments with the ability to continue logical replication from a new primary node after the failover. 
+* Gain more control for managing PostgreSQL databases in high availability environments with the ability to continue logical replication from a new primary node after the failover.
 * Track inactive and invalid replication slots in the `pg_replication_slots` view. With the  `inactive_since` and `invalidation_reason` columns  added to this view, you can get insights when a slot became inactive as well as the reason for an invalid slot.
 * Convert a physical replica into a logical one using the new [`pg_createsubscriber`](https://www.postgresql.org/docs/17/app-pgcreatesubscriber.html) command-line tool
 
@@ -80,10 +79,10 @@ This feature is especially beneficial for organizations with large data sets whe
 
 #### Monitoring improvements
 
-* Get deeper insights about query plans and execution with the new options for the EXPLAIN command: 
+* Get deeper insights about query plans and execution with the new options for the EXPLAIN command:
 
    * SERIALIZE shows the amount of time it takes to convert data for network transmission
-   * MEMORY reports optimizer memory usage 
+   * MEMORY reports optimizer memory usage
 
 * Learn about why an active session is waiting using the `pg_stat_activity` and new `pg_wait_events` views
 
@@ -99,14 +98,12 @@ Participate in monthly SWAG raffles, get an early access to new product features
 
 ## Known Limitations
 
-Percona Monitoring and Management (PMM) 2.43.1 is not compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. However, PMM is compatible with `pg_stat_monitor` 2.1.0 for monitoring of PostgreSQL 16 and previous versions. 
+Percona Monitoring and Management (PMM) 2.43.1 is not compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. However, PMM is compatible with `pg_stat_monitor` 2.1.0 for monitoring of PostgreSQL 16 and previous versions.
 
 The support for PostgreSQL 17 will be available in the future PMM release.
 
-
 ------------------------------------------------------------------------------
 
-
 The following is the list of extensions available in Percona Distribution for PostgreSQL.
 
 | Extension           | Version        | Description                  |
@@ -130,8 +127,8 @@ The following is the list of extensions available in Percona Distribution for Po
 Percona Distribution for PostgreSQL on Red Hat Enterprise Linux 8 and compatible derivatives also includes the following packages:
 
 * `llvm` 17.0.6 packages. This fixes compatibility issues with LLVM from upstream.
-* supplemental `python3-etcd` packages, which can be used for setting up Patroni clusters. 
+* supplemental `python3-etcd` packages, which can be used for setting up Patroni clusters.
 
 Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/17/libpq.html) library. It contains "a set of
 library functions that allow client programs to pass queries to the PostgreSQL
-backend server and to receive the results of these queries." 
+backend server and to receive the results of these queries."
diff --git a/docs/release-notes/release-notes-v17.2.md b/docs/release-notes/release-notes-v17.2.md
@@ -2,19 +2,19 @@
 
 --8<-- "release-notes-intro.md"
 
-This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.2.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.2](https://www.postgresql.org/docs/17/release-17-2.html). 
+This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.2.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.2](https://www.postgresql.org/docs/17/release-17-2.html).
 
 ## Release Highlights
 
-* This release includes fixes for [CVE-2024-10978](https://www.postgresql.org/support/security/CVE-2024-10978/) and for certain PostgreSQL extensions that break because they depend on the modified Application Binary Interface (ABI). These regressions were introduced in PostgreSQL 17.1, 16.5, 15.9, 14.14, 13.17, and 12.21. For this reason, the release of Percona Distribution for PostgreSQL 17.1.1 has been skipped. 
+* This release includes fixes for [CVE-2024-10978](https://www.postgresql.org/support/security/CVE-2024-10978/) and for certain PostgreSQL extensions that break because they depend on the modified Application Binary Interface (ABI). These regressions were introduced in PostgreSQL 17.1, 16.5, 15.9, 14.14, 13.17, and 12.21. For this reason, the release of Percona Distribution for PostgreSQL 17.1.1 has been skipped.
 * Percona Distribution for PostgreSQL includes [`pgvector` :octicons-link-external-16:](https://github.com/pgvector/pgvector) - an open source extension that enables you to use PostgreSQL as a vector database. It brings vector data type and vector operations (mainly similarity search) to PostgreSQL. You can install `pgvector` from repositories, tarballs, and it is also available as a Docker image.
 * The new version of `pg_tde` extension features index encryption and the support of storing encryption keys in KMIP-compatible servers. These feature come with the Beta version of the `tde_heap` access method. Learn more in the [pg_tde release notes :octicons-link-external-16:](https://docs.percona.com/pg-tde/release-notes/beta2.html)
-* The `pg_tde` extension itself is now a part of the Percona Server for PostgreSQL server package and a Docker image. If you installed the extension before, from its individual package, uninstall it first to avoid conflicts during the upgrade. See the [Minor Upgrade of Percona Distribution for PostgreSQL](minor-upgrade.md#before-you-start) for details.
+* The `pg_tde` extension itself is now a part of the Percona Server for PostgreSQL server package and a Docker image. If you installed the extension before, from its individual package, uninstall it first to avoid conflicts during the upgrade. See the [Minor Upgrade of Percona Distribution for PostgreSQL](../minor-upgrade.md#before-you-start) for details.
+
+   For how to run `pg_tde` in Docker, check the [Enable encryption](../docker.md#enable-encryption) section in the documentation.
 
-   For how to run `pg_tde` in Docker, check the [Enable encryption](docker.md#enable-encryption) section in the documentation.
-   
 *  Percona Distribution for PostgreSQL now statically links `llvmjit.so` library for Red Hat Enterprise Linux 8 and 9 and compatible derivatives. This resolves the conflict between the LLVM version required by Percona Distribution for PostgreSQL and the one supplied with the operating system. This also enables you to use the LLVM modules supplied with the operating system for other software you require.
-* Percona Monitoring and Management (PMM) 2.43.2 is now compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. 
+* Percona Monitoring and Management (PMM) 2.43.2 is now compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17.
 
 ------------------------------------------------------------------------------
 
@@ -43,8 +43,8 @@ The following is the list of extensions available in Percona Distribution for Po
 For Red Hat Enterprise Linux 8 and 9 and compatible derivatives, Percona Distribution for PostgreSQL also includes the following packages:
 
 * `llvm` 17.0.6 packages. This fixes compatibility issues with LLVM from upstream.
-* supplemental `python3-etcd` 0.4.5 packages, which can be used for setting up Patroni clusters. 
+* supplemental `python3-etcd` 0.4.5 packages, which can be used for setting up Patroni clusters.
 
 Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/17/libpq.html) library. It contains "a set of
 library functions that allow client programs to pass queries to the PostgreSQL
-backend server and to receive the results of these queries." 
+backend server and to receive the results of these queries."
diff --git a/docs/release-notes/release-notes-v17.4.md b/docs/release-notes/release-notes-v17.4.md
@@ -2,7 +2,7 @@
 
 --8<-- "release-notes-intro.md"
 
-This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.4.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.4](https://www.postgresql.org/docs/17/release-17-4.html). 
+This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.4.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.4](https://www.postgresql.org/docs/17/release-17-4.html).
 
 ## Release Highlights
 
@@ -16,15 +16,15 @@ Percona Distribution for PostgreSQL includes the Release Candidate of `pg_tde` e
 
 * Percona Distribution for PostgreSQL Docker image is now based on Universal Base Image (UBI) version 9, which includes the latest security fixes. This makes the image compliant with the Red Hat certification and ensures the seamless work of containers on Red Hat OpenShift Container Platform.
 
-* You no longer have to specify the `{{dockertag}}-multi` tag when you run Percona Distribution for PostgreSQL in Docker. Instead, use the `percona/percona-distribution-postgresql:{{dockertag}}`. Docker automatically identifies the architecture of your operating system and pulls the corresponding image. Refer to [Run in Docker](docker.md) for how to get started.
+* You no longer have to specify the `{{dockertag}}-multi` tag when you run Percona Distribution for PostgreSQL in Docker. Instead, use the `percona/percona-distribution-postgresql:{{dockertag}}`. Docker automatically identifies the architecture of your operating system and pulls the corresponding image. Refer to [Run in Docker](../docker.md) for how to get started.
 
 ### PostGIS is included into tarballs
 
-We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an open-source extension to handle spatial data. This way you can install and run PostgreSQL as a geospatial database on hosts without a direct access to the Internet. Learn more about [installing from tarballs](tarball.md) and [Spatial data manipulation](solutions/postgis.md). 
+We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an open-source extension to handle spatial data. This way you can install and run PostgreSQL as a geospatial database on hosts without a direct access to the Internet. Learn more about [installing from tarballs](../tarball.md) and [Spatial data manipulation](../solutions/postgis.md).
 
 ### Deprecation of meta packages
 
-[Meta-packages for Percona Distribution for PostgreSQL](repo-overview.md#repository-contents) are deprecated and will be removed in future releases.
+[Meta-packages for Percona Distribution for PostgreSQL](../repo-overview.md#repository-contents) are deprecated and will be removed in future releases.
 
 ## Supplied third-party extensions
 
@@ -49,9 +49,8 @@ Review each extension’s release notes for What’s new, improvements, or bug f
 | [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 267 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously              |
 | [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json)          | 2.6       | A PostgreSQL logical decoding JSON output plugin                                                                    |
 
-
-For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the  supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. 
+For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the  supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters.
 
 Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/17/libpq.html) library. It contains "a set of
 library functions that allow client programs to pass queries to the PostgreSQL
-backend server and to receive the results of these queries." 
+backend server and to receive the results of these queries."
diff --git a/docs/release-notes/release-notes-v17.5.1.md b/docs/release-notes/release-notes-v17.5.1.md
@@ -12,7 +12,7 @@ Percona Distribution for PostgreSQL includes the Release Candidate 2 (RC2) of `p
 
 ### Updated Major upgrade topic in documentation
 
-The [Upgrading Percona Distribution for PostgreSQL from 16 to 17](major-upgrade.md) guide has been updated with revised steps for the [On Debian and Ubuntu using `apt`](major-upgrade.md/#on-debian-and-ubuntu-using-apt) section, improving clarity and reliability of the upgrade process.
+The [Upgrading Percona Distribution for PostgreSQL from 16 to 17](../major-upgrade.md) guide has been updated with revised steps for the [On Debian and Ubuntu using `apt`](../major-upgrade.md/#on-debian-and-ubuntu-using-apt) section, improving clarity and reliability of the upgrade process.
 
 | Extension                                                                            | Version   | Description                                                                                                          |
 |--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------|
diff --git a/docs/release-notes/release-notes-v17.5.md b/docs/release-notes/release-notes-v17.5.md
diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md
@@ -0,0 +1,14 @@
+# Percona Server for PostgreSQL release notes
+
+This page lists all release notes for Percona Server for PostgreSQL 17, organized by year and version. Use it to track new features, fixes, and updates across major and minor versions.
+
+## 2025
+
+* [17.5.2](release-notes-v17.5.md) ({{date.17_5}})
+* [17.5.1](release-notes-v17.5.1.md) ({{date.17_5_1}})
+* [17.4.1](release-notes-v17.4.md) ({{date.17_4}})
+
+## 2024
+
+* [17.2.1](release-notes-v17.2.md) ({{date.17_2}})
+* [17.0.1](release-notes-v17.0.md) ({{date.17_0}})
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -84,13 +84,15 @@ nav:
       - migration.md
   - Troubleshooting guide: troubleshooting.md
   - Uninstall: uninstalling.md
-  - Release Notes:
-      - "Release notes index": "release-notes.md"
-      - release-notes-v17.5.md
-      - release-notes-v17.5.1.md
-      - release-notes-v17.4.md
-      - release-notes-v17.2.md
-      - release-notes-v17.0.md
+  - Release notes:
+      - "Release notes index": release-notes/release-notes.md
+      - 2025:
+        - "17.5.2": release-notes/release-notes-v17.5.md
+        - "17.5.1": release-notes/release-notes-v17.5.1.md
+        - "17.4.1": release-notes/release-notes-v17.4.md
+      - 2024 (versions 17.0.1 - 17.2.1):
+        - "17.2.1": release-notes/release-notes-v17.2.md
+        - "17.0.1": release-notes/release-notes-v17.0.md
   - Reference:
       - Telemetry: telemetry.md
       - Licensing: licensing.md
