From 2b1af15f2be91496b08b4a4fe46ae8cef893a83a Mon Sep 17 00:00:00 2001
From: Rachel Mackintosh <148898879+rachel-mack@users.noreply.github.com>
Date: Tue, 27 May 2025 12:15:08 -0400
Subject: [PATCH] rename what's new (#698)

---
 config/redirects                                      | 1 +
 source/index.txt                                      | 6 +++---
 source/reference.txt                                  | 9 +++++++--
 source/reference/legacy.txt                           | 2 +-
 source/reference/{whats-new.txt => release-notes.txt} | 7 ++++---
 5 files changed, 16 insertions(+), 9 deletions(-)
 rename source/reference/{whats-new.txt => release-notes.txt} (99%)

diff --git a/config/redirects b/config/redirects
index 5373422cc..88042cc3a 100644
--- a/config/redirects
+++ b/config/redirects
@@ -69,3 +69,4 @@ raw: ${prefix}/master -> ${base}/upcoming/
 [v5.0-master]: ${prefix}/${version}/quick-reference/ -> ${base}/${version}/getting-started/quick-reference/
 [v5.0-master]: ${prefix}/${version}/fundamentals/enterprise-auth/ -> ${base}/${version}/security/enterprise-auth/
 [v5.0-master]: ${prefix}/${version}/connection/socks/ -> ${base}/${version}/security/socks/
+[v5.0-*]: ${prefix}/${version}/whats-new/ -> ${base}/${version}/reference/release-notes/
diff --git a/source/index.txt b/source/index.txt
index 74896d726..f4f7f91ea 100644
--- a/source/index.txt
+++ b/source/index.txt
@@ -69,11 +69,11 @@ Quick Reference
 See driver syntax examples for common MongoDB commands in the
 :ref:`Quick Reference <java-quick-reference>` section.
 
-What's New
-----------
+Release Notes
+-------------
 
 For a list of new features and changes in each version, see the
-:ref:`What's New <java-whats-new>` section.
+:ref:`Release Notes <java-release-notes>` section.
 
 Usage Examples
 --------------
diff --git a/source/reference.txt b/source/reference.txt
index 3380ae0db..6bdb9fd27 100644
--- a/source/reference.txt
+++ b/source/reference.txt
@@ -9,7 +9,12 @@ Reference
    :titlesonly:
    :maxdepth: 1
 
-   Release Notes </reference/whats-new>
+   Release Notes </reference/release-notes>
    Compatibility </reference/compatibility>
    Upgrade </reference/upgrade>
-   Migrate from the Legacy API </reference/legacy>
\ No newline at end of file
+   Migrate from the Legacy API </reference/legacy>
+
+- :ref:`Release Notes <java-release-notes>`
+- :ref:`Compatibility <java-compatibility-tables>`
+- :ref:`Upgrade <java-upgrade-driver>`
+- :ref:`Migrate from the Legacy API <java-legacy-api>`
diff --git a/source/reference/legacy.txt b/source/reference/legacy.txt
index d46411db7..3a0d88d1b 100644
--- a/source/reference/legacy.txt
+++ b/source/reference/legacy.txt
@@ -62,7 +62,7 @@ API include:
 - **Native POJO support**, which provides automatic or custom mapping between
   MongoDB documents and Java objects
 
-To learn about more features of the current API, see :ref:`java-whats-new`.
+To learn about more features of the current API, see :ref:`java-release-notes`.
 
  
 API Changes
diff --git a/source/reference/whats-new.txt b/source/reference/release-notes.txt
similarity index 99%
rename from source/reference/whats-new.txt
rename to source/reference/release-notes.txt
index 569db101a..ef7fc4257 100644
--- a/source/reference/whats-new.txt
+++ b/source/reference/release-notes.txt
@@ -1,8 +1,9 @@
 .. _java-whats-new:
+.. _java-release-notes:
 
-==========
-What's New
-==========
+=============
+Release Notes
+=============
 
 .. facet::
    :name: genre