From 46bec8391b93a54eeff8d939bc048cafe64ecf43 Mon Sep 17 00:00:00 2001
From: Mihail Geshoski <mihail@moodle.com>
Date: Thu, 5 Feb 2026 20:22:57 +0800
Subject: [PATCH] NOBUG: Add upgrade notes

---
 UPGRADING.md                     | 11 +++++++++++
 public/ai/placement/UPGRADING.md | 10 ++++++++++
 public/lib/UPGRADING.md          |  3 +++
 3 files changed, 24 insertions(+)
 create mode 100644 public/ai/placement/UPGRADING.md

diff --git a/UPGRADING.md b/UPGRADING.md
index 024969a5f99..66430a05f5c 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -75,6 +75,9 @@ The format of this change log follows the advice given at [Keep a CHANGELOG](htt
 - The Hook Manager now uses localcache instead of caching via MUC.
 
   For more information see [MDL-87107](https://tracker.moodle.org/browse/MDL-87107)
+- `\core\output\core_renderer::confirm()`'s `$displayoptions` parameter now also accepts a `headinglevel` option that developers can use to specify the heading level of the confirmation's heading. If not specified, the confirmation heading will be rendered in an `h4` tag.
+
+  For more information see [MDL-87694](https://tracker.moodle.org/browse/MDL-87694)
 
 #### Removed
 
@@ -574,6 +577,14 @@ The format of this change log follows the advice given at [Keep a CHANGELOG](htt
 
   For more information see [MDL-87034](https://tracker.moodle.org/browse/MDL-87034)
 
+### aiplacement
+
+#### Added
+
+- A new page-level property has been added to moodle_page to indicate whether AI-related UI elements are preferred to be shown on a given page. This value acts as an advisory hint only. It does not enforce the visibility of AI-related UI elements globally.
+
+  For more information see [MDL-87658](https://tracker.moodle.org/browse/MDL-87658)
+
 ### auth_ldap
 
 #### Removed
diff --git a/public/ai/placement/UPGRADING.md b/public/ai/placement/UPGRADING.md
new file mode 100644
index 00000000000..ca3386824ba
--- /dev/null
+++ b/public/ai/placement/UPGRADING.md
@@ -0,0 +1,10 @@
+# aiplacement (plugin type) Upgrade notes
+
+## 5.2dev
+
+### Added
+
+- A new page-level property has been added to moodle_page to indicate whether AI-related UI elements are preferred to be shown on a given page. This value acts as an advisory hint only. It does not enforce the visibility of AI-related UI elements globally.
+
+  For more information see [MDL-87658](https://tracker.moodle.org/browse/MDL-87658)
+
diff --git a/public/lib/UPGRADING.md b/public/lib/UPGRADING.md
index 2b1acbad08b..6d9b25a45b6 100644
--- a/public/lib/UPGRADING.md
+++ b/public/lib/UPGRADING.md
@@ -67,6 +67,9 @@
 - The Hook Manager now uses localcache instead of caching via MUC.
 
   For more information see [MDL-87107](https://tracker.moodle.org/browse/MDL-87107)
+- `\core\output\core_renderer::confirm()`'s `$displayoptions` parameter now also accepts a `headinglevel` option that developers can use to specify the heading level of the confirmation's heading. If not specified, the confirmation heading will be rendered in an `h4` tag.
+
+  For more information see [MDL-87694](https://tracker.moodle.org/browse/MDL-87694)
 
 ### Removed