From 144a9fa0270fa5d13627de9c99be0bb722f7711a Mon Sep 17 00:00:00 2001
From: Huong Nguyen <huongnv13@gmail.com>
Date: Fri, 25 Oct 2024 08:35:34 +0700
Subject: [PATCH] NOBUG: Add upgrade notes

---
 UPGRADING.md       | 27 +++++++++++++++++++++++++++
 enrol/UPGRADING.md | 12 ++++++++++++
 lib/UPGRADING.md   | 15 +++++++++++++++
 3 files changed, 54 insertions(+)
 create mode 100644 enrol/UPGRADING.md

diff --git a/UPGRADING.md b/UPGRADING.md
index 027422a1b1627..a45f5e689ca0f 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -6,6 +6,33 @@ More detailed information on key changes can be found in the [Developer update n
 
 The format of this change log follows the advice given at [Keep a CHANGELOG](https://keepachangelog.com).
 
+## 5.0dev
+
+### core
+
+#### Changed
+
+- All uses of the following PHPUnit methods have been removed as these methods are
+  deprecated upstream without direct replacement:
+
+  - `withConsecutive`
+  - `willReturnConsecutive`
+  - `onConsecutive`
+
+  Any plugin using these methods must update their uses.
+
+  For more information see [MDL-81308](https://tracker.moodle.org/browse/MDL-81308)
+
+### core_enrol
+
+#### Changed
+
+- The `after_user_enrolled` hook now contains a `roleid` property to allow for listeners to determine which role was assigned during user enrolment (if any)
+
+  The base enrolment `enrol_plugin::send_course_welcome_message_to_user` method also now accepts a `$roleid` parameter in order to correctly populate the `courserole` placeholder
+
+  For more information see [MDL-83432](https://tracker.moodle.org/browse/MDL-83432)
+
 ## 4.5
 
 ### core
diff --git a/enrol/UPGRADING.md b/enrol/UPGRADING.md
new file mode 100644
index 0000000000000..55ba76ab5b065
--- /dev/null
+++ b/enrol/UPGRADING.md
@@ -0,0 +1,12 @@
+# core_enrol (subsystem / plugintype) Upgrade notes
+
+## 5.0dev
+
+### Changed
+
+- The `after_user_enrolled` hook now contains a `roleid` property to allow for listeners to determine which role was assigned during user enrolment (if any)
+
+  The base enrolment `enrol_plugin::send_course_welcome_message_to_user` method also now accepts a `$roleid` parameter in order to correctly populate the `courserole` placeholder
+
+  For more information see [MDL-83432](https://tracker.moodle.org/browse/MDL-83432)
+
diff --git a/lib/UPGRADING.md b/lib/UPGRADING.md
index ce0fcbc7c6b4d..30d3c6dfccd8a 100644
--- a/lib/UPGRADING.md
+++ b/lib/UPGRADING.md
@@ -1,5 +1,20 @@
 # core (subsystem) Upgrade notes
 
+## 5.0dev
+
+### Changed
+
+- All uses of the following PHPUnit methods have been removed as these methods are
+  deprecated upstream without direct replacement:
+
+  - `withConsecutive`
+  - `willReturnConsecutive`
+  - `onConsecutive`
+
+  Any plugin using these methods must update their uses.
+
+  For more information see [MDL-81308](https://tracker.moodle.org/browse/MDL-81308)
+
 ## 4.5
 
 ### Added