elastic · jrodewig · Aug 3, 2023 · Aug 3, 2023
@@ -31,8 +31,8 @@ include::./config-file-format.asciidoc[]
 
 include::./upgrading.asciidoc[]
 
-include::./release-notes/breaking/breaking.asciidoc[]
-
 include::./release.asciidoc[]
 
+include::./release-notes/breaking/breaking.asciidoc[]
+
 include::{libbeat-dir}/contributing-to-beats.asciidoc[]
@@ -5,14 +5,7 @@
 <titleabbrev>7.17</titleabbrev>
 ++++
 
-//NOTE: The notable-breaking-changes tagged regions are re-used in the
-//Installation and Upgrade Guide
-
-// tag::notable-breaking-changes[]
-
 The Docker base image has changed from CentOS 7 to Ubuntu 20.04. This change
 affects all {beats}.
 
-// end::notable-breaking-changes[]
-
 {see-relnotes}
@@ -9,11 +9,6 @@ See the <<release-notes,release notes>> for a complete list of breaking changes,
 bug fixes, and enhancements, including changes to beta or experimental
 functionality.
 
-//NOTE: The notable-breaking-changes tagged regions are re-used in the
-//Installation and Upgrade Guide
-
-//tag::notable-breaking-changes[]
-
 [discrete]
 ==== {beats} logs are now ECS-compliant
 
@@ -92,7 +87,3 @@ However this caused problems for some users.
 
 Starting in version 8.0.0, filesets are disabled by default. You must explicitly
 enable the filesets you want {filebeat} to use.
-
-// end::notable-breaking-changes[]
-
-
@@ -9,23 +9,10 @@ changes, but there are breaking changes between major versions (e.g. 7.x to
 8.y). Migrating directly between non consecutive major versions (e.g. 6.x to
 8.x) is not recommended.
 
-See the following topics for a description of breaking changes:
+See the following topics for a description of breaking changes between major versions:
 
-* <<breaking-changes-8.5>>
-* <<breaking-changes-8.4>>
-* <<breaking-changes-8.3>>
-* <<breaking-changes-8.2>>
-* <<breaking-changes-8.1>>
 * <<breaking-changes-8.0>>
 
-include::breaking-8.5.asciidoc[]
-
-include::breaking-8.4.asciidoc[]
-
-include::breaking-8.3.asciidoc[]
-
-include::breaking-8.2.asciidoc[]
-
-include::breaking-8.1.asciidoc[]
+For breaking changes between minor versions, see the <<release-notes,release notes>>.
 
 include::breaking-8.0.asciidoc[]
@@ -3,3 +3,33 @@
 
 This page has moved. Please see {observability-guide}/whats-new.html[What's new
 in Observability {minor-version}].
+
+[role="exclude",id="breaking-changes-8.5"]
+== Breaking changes in 8.5
+
+This page no longer exists.
+There are no notable breaking changes for 8.5.
+
+[role="exclude",id="breaking-changes-8.4"]
+== Breaking changes in 8.4
+
+This page no longer exists.
+There are no notable breaking changes for 8.4.
+
+[role="exclude",id="breaking-changes-8.3"]
+== Breaking changes in 8.3
+
+This page no longer exists.
+There are no notable breaking changes for 8.3.
+
+[role="exclude",id="breaking-changes-8.2"]
+== Breaking changes in 8.2
+
+This page no longer exists.
+There are no notable breaking changes for 8.2.
+
+[role="exclude",id="breaking-changes-8.1"]
+== Breaking changes in 8.1
+
+This page no longer exists.
+There are no notable breaking changes for 8.1.