elastic · KOTungseth · Mar 17, 2025 · Mar 13, 2025 · Mar 13, 2025 · Mar 13, 2025
@@ -3,7 +3,7 @@ navigation_title: "Elastic APM"
 ---
 
 # Elastic APM breaking changes [elastic-apm-breaking-changes]
-Before you upgrade, carefully review the Elastic APM breaking changes and take the necessary steps to mitigate any issues. 
+Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the Elastic APM breaking changes and take the necessary steps to mitigate any issues. 
 
 To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +18,7 @@ To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 ## 9.0.0 [elastic-apm-9-0-0-breaking-changes]
-**Release date:** April 1, 2025
+**Release date:** April 2, 2025
 
 % ::::{dropdown} Title of breaking change 
 % Description of the breaking change.

@@ -3,7 +3,9 @@ navigation_title: "Elastic APM"
 ---
 
 # Elastic APM deprecations [elastic-apm-deprecations]
-Review the deprecated functionality for your Elastic APM version. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
+Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. 
+
+Review the deprecated functionality for Elastic APM. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
 
 To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +20,7 @@ To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [elastic-apm-900-deprecations]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Deprecation title
 % Description of the deprecation.

@@ -6,7 +6,7 @@ navigation_title: "Elastic APM"
 ---
 
 # Elastic APM known issues [elastic-apm-known-issues]
-Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Reviewing known issues can help you make informed decisions, such as upgrading to a new version.
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the Elastic APM known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -0,0 +1,6 @@
+toc:
+  - file: release-notes.md
+    children:
+      - file: known-issues.md
+      - file: breaking-changes.md
+      - file: deprecations.md
@@ -2,7 +2,7 @@
 navigation_title: "Elastic Cloud Serverless"
 ---
 # {{serverless-full}} known issues [elastic-cloud-serverless-known-issues]
-Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Reviewing known issues can help you make informed decisions.
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the {{serverless-full}} known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -0,0 +1,5 @@
+toc:
+  - file: changelog.md
+    children:
+      - file: known-issues.md
+      - file: deprecations.md
@@ -3,7 +3,7 @@ navigation_title: "Elastic Observability"
 ---
 
 # Elastic {{observability}} breaking changes [elastic-observability-breaking-changes]
-Before you upgrade, carefully review the Elastic {{observability}} breaking changes and take the necessary steps to mitigate any issues. 
+Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the Elastic {{observability}} breaking changes and take the necessary steps to mitigate any issues. 
 
 To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +18,7 @@ To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [elastic-observability-900-breaking-changes]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Title of breaking change 
 % Description of the breaking change.

@@ -3,7 +3,9 @@ navigation_title: "Elastic Observability"
 ---
 
 # Elastic {{observability}} deprecations [elastic-observability-deprecations]
-Review the deprecated functionality for your Elastic {{observability}} version. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
+Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. 
+
+Review the deprecated functionality for Elastic {{observability}}. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
 
 To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +20,7 @@ To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [elastic-observability-900-deprecations]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Deprecation title
 % Description of the deprecation.

@@ -3,7 +3,7 @@ navigation_title: "Elastic Observability"
 ---
 
 # Elastic {{observability}} known issues [elastic-observability-known-issues]
-Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Reviewing known issues can help you make informed decisions, such as upgrading to a new version.
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the Elastic {{observability}} known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -0,0 +1,6 @@
+toc:
+  - file: release-notes.md
+    children:
+      - file: known-issues.md
+      - file: breaking-changes.md
+      - file: deprecations.md
@@ -1,9 +1,8 @@
 ---
 navigation_title: "Elastic Security"
 ---
-
 # {{elastic-sec}} breaking changes [elastic-security-breaking-changes]
-Before you upgrade, carefully review the {{elastic-sec}} breaking changes and take the necessary steps to mitigate any issues. 
+Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the {{elastic-sec}} breaking changes and take the necessary steps to mitigate any issues. 
 
 To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +17,7 @@ To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 ## 9.0.0 [elastic-security-900-breaking-changes]
-**Release date:** April 1, 2025
+**Release date:** April 2, 2025
 
 ::::{dropdown} Removed legacy security rules bulk endpoints
 * `POST /api/detection_engine/rules/_bulk_create` has been replaced by `POST /api/detection_engine/rules/_import`

@@ -3,7 +3,9 @@ navigation_title: "Elastic Security"
 ---
 
 # {{elastic-sec}} deprecations [elastic-security-deprecations]
-Review the deprecated functionality for your {{elastic-sec}} version. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
+Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. 
+
+Review the deprecated functionality for {{elastic-sec}}. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
 
 To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +20,7 @@ To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [elastic-security-900-deprecations]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Deprecation title
 % Description of the deprecation.

@@ -6,7 +6,7 @@ navigation_title: "Elastic Security"
 ---
 
 # {{elastic-sec}} known issues [elastic-security-known-issues]
-Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Reviewing known issues can help you make informed decisions, such as upgrading to a new version.
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the {{elastic-sec}} known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -0,0 +1,6 @@
+toc:
+  - file: release-notes.md
+    children:
+      - file: known-issues.md
+      - file: breaking-changes.md
+      - file: deprecations.md
@@ -3,7 +3,7 @@ navigation_title: "Fleet and Elastic Agent"
 ---
 
 # {{fleet}} and {{agent}} breaking changes [fleet-elastic-agent-breaking-changes]
-Before you upgrade, carefully review the {{fleet}} and {{agent}} breaking changes and take the necessary steps to mitigate any issues. 
+Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the {{fleet}} and {{agent}} breaking changes and take the necessary steps to mitigate any issues. 
 
 To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +18,7 @@ To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [fleet-elastic-agent-900-breaking-changes]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Title of breaking change 
 % Description of the breaking change.

@@ -3,7 +3,9 @@ navigation_title: "Fleet and Elastic Agent"
 ---
 
 # {{fleet}} and {{agent}} deprecations [fleet-elastic-agent-deprecations]
-Review the deprecated functionality for your {{fleet}} and {{agent}} version. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
+Over time, certain Elastic functionality becomes outdated and is replaced or removed. To help with the transition, Elastic deprecates functionality for a period before removal, giving you time to update your applications. 
+
+Review the deprecated functionality for {{fleet}} and {{agent}}. While deprecations have no immediate impact, we strongly encourage you update your implementation after you upgrade.
 
 To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 
@@ -18,7 +20,7 @@ To learn how to upgrade, check out [Upgrade](/deploy-manage/upgrade.md).
 % ::::
 
 % ## 9.0.0 [fleet-elastic-agent-900-deprecations]
-% **Release date:** April 1, 2025
+% **Release date:** April 2, 2025
 
 % ::::{dropdown} Deprecation title
 % Description of the deprecation.

@@ -3,7 +3,7 @@ navigation_title: "Fleet and Elastic Agent"
 ---
 
 # {{fleet}} and {{agent}} known issues [fleet-elastic-agent-known-issues]
-Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Reviewing known issues can help you make informed decisions, such as upgrading to a new version.
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the {{fleet}} and {{agent}} known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -26,7 +26,7 @@ To check for security updates, go to [Security announcements for the Elastic sta
 
 
 ## 9.0.0 [fleet-elastic-agent-900-release-notes]
-**Release date:** April 1, 2025
+**Release date:** April 2, 2025
 
 ### Features and enhancements [fleet-elastic-agent-900-features-enhancements]
 

@@ -0,0 +1,6 @@
+toc:
+  - file: release-notes.md
+    children:
+      - file: known-issues.md
+      - file: breaking-changes.md
+      - file: deprecations.md
@@ -2,11 +2,11 @@
 
 Learn about the latest changes, issues, fixes, and deprecations for Elastic releases by reviewing the release notes. 
 
-For information about the latest changes to Elastic APIs, check the [APIs changelog](https://www.elastic.co/docs/api/changes).
+For information about the latest changes to Elastic APIs, check [APIs changelog](https://www.elastic.co/docs/api/changes).
 
 We recommend you upgrade to the latest Elastic version. To learn how to upgrade, check [Upgrade](/deploy-manage/upgrade.md).
 
-Additional resources:
+To learn more about Elastic releases, use the following resources:
 * Join the [Elastic community forums](https://discuss.elastic.co/) 
 * Check out the [Elastic Blog](https://www.elastic.co/blog)
 * Reach out to [Elastic Support](https://mail.google.com/mail/u/0/?fs=1&tf=cm&source=mailto&[email protected])
@@ -6,6 +6,7 @@ navigation_title: "Search"
 ---
 
 # Search known issues [search-known-issues]
+Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the {{fleet}} and {{agent}} known issues to help you make informed decisions, such as upgrading to a new version.
 
 % Use the following template to add entries to this page.
 

@@ -1,32 +1,26 @@
 toc:
   - file: index.md
-  - file: known-issues/index.md
+  - file: elastic-observability/release-notes.md
     children:
-      - file: known-issues/search-ui.md
-      - file: known-issues/elastic-observability.md
-        children:
-          - file: known-issues/elastic-apm.md
-      - file: known-issues/elastic-security.md
-      - file: known-issues/fleet-elastic-agent.md
-      - file: known-issues/elastic-cloud-serverless.md
-  - file: breaking-changes/index.md
+      - file: elastic-observability/known-issues.md
+      - file: elastic-observability/breaking-changes.md
+      - file: elastic-observability/deprecations.md
+  - file: elastic-apm/release-notes.md
     children:
-      - file: breaking-changes/elastic-observability.md
-        children:
-          - file: breaking-changes/elastic-apm.md
-      - file: breaking-changes/elastic-security.md
-      - file: breaking-changes/fleet-elastic-agent.md
-  - file: deprecations/index.md
+      - file: elastic-apm/known-issues.md
+      - file: elastic-apm/breaking-changes.md
+      - file: elastic-apm/deprecations.md
+  - file: elastic-security/release-notes.md
     children:
-      - file: deprecations/elastic-observability.md
-        children:
-          - file: deprecations/elastic-apm.md
-      - file: deprecations/elastic-security.md
-      - file: deprecations/fleet-elastic-agent.md
-      - file: deprecations/elastic-cloud-serverless.md
-  - file: elastic-observability.md
+      - file: elastic-security/known-issues.md
+      - file: elastic-security/breaking-changes.md
+      - file: elastic-security/deprecations.md
+  - file: elastic-cloud-serverless/changelog.md
     children:
-      - file: elastic-apm.md
-  - file: elastic-security.md
-  - file: fleet-elastic-agent.md
-  - file: elastic-cloud-serverless.md
+      - file: elastic-cloud-serverless/known-issues.md
+      - file: elastic-cloud-serverless/deprecations.md
+  - file: fleet-elastic-agent/release-notes.md
+    children:
+      - file: fleet-elastic-agent/known-issues.md
+      - file: fleet-elastic-agent/breaking-changes.md
+      - file: fleet-elastic-agent/deprecations.md
-Original file line number
+Diff line change
@@ Expand Up / @@ -6,6 +6,7 @@ navigation_title: "Search" @@
     ---
     # Search known issues [search-known-issues]
+    Known issues are significant defects or limitations that may impact your implementation. These issues are actively being worked on and will be addressed in a future release. Review the {{fleet}} and {{agent}} known issues to help you make informed decisions, such as upgrading to a new version.
     % Use the following template to add entries to this page.
@@ Expand Down @@