elastic · florent-leborgne · Oct 7, 2024 · Sep 18, 2024 · Sep 19, 2024 · Sep 23, 2024
diff --git a/docs/CHANGELOG.asciidoc b/docs/CHANGELOG.asciidoc
@@ -72,6 +72,8 @@ Review important information about the {kib} 8.x releases.
 
 --
 
+include::upgrade-notes.asciidoc[]
+
 [[release-notes-8.15.1]]
 == {kib} 8.15.1
 

diff --git a/docs/setup/upgrade.asciidoc b/docs/setup/upgrade.asciidoc
@@ -6,6 +6,8 @@ To upgrade from 7.16.0 or earlier to {version},
 {stack-ref}/upgrading-elastic-stack.html#prepare-to-upgrade[prepare for the upgrade].
 Before you upgrade, you must resolve all critical issues identified by the *Upgrade Assistant*.
 
+In addition, we recommend to carefully review the <<breaking-changes-summary,list of breaking changes and deprecations>> and to take any necessary actions to mitigate their impact on the upgrade.
+
 Rolling upgrades are unsupported in {kib}. To upgrade,
 you must shut down all {kib} instances, install the new software, and restart {kib}.
 Upgrading while older {kib} instances are running can cause data loss or upgrade failures.
-Original file line number
+Diff line change
@@ Expand Up / @@ -72,6 +72,8 @@ Review important information about the {kib} 8.x releases. @@
     --
+    include::upgrade-notes.asciidoc[]
     [[release-notes-8.15.1]]
     == {kib} 8.15.1
@@ Expand Down @@