diff --git a/docs/migration/migrate_8_0.asciidoc b/docs/migration/migrate_8_0.asciidoc
index a0fa38f2e0f77..2f3f861ffc8e8 100644
--- a/docs/migration/migrate_8_0.asciidoc
+++ b/docs/migration/migrate_8_0.asciidoc
@@ -11,15 +11,18 @@ coming[8.0.0]
 
 See also <<release-highlights>> and <<release-notes>>.
 
-////
-The following section is re-used in the Installation and Upgrade Guide
-[[breaking_80_notable]]
-=== Notable breaking changes
-////
-// tag::notable-breaking-changes[]
+* <<breaking_80_setting_changes>>
+
+//NOTE: The notable-breaking-changes tagged regions are re-used in the
+//Installation and Upgrade Guide
 
 [float]
-=== Default logging timezone is now the system's timezone
+[[breaking_80_setting_changes]]
+=== Settings changes
+
+// tag::notable-breaking-changes[]
+[float]
+==== Default logging timezone is now the system's timezone
 *Details:* In prior releases the timezone used in logs defaulted to UTC.  We now use the host machine's timezone by default.
 
 *Impact:* To restore the previous behavior, in kibana.yml set `logging.timezone: UTC`.