From 48b1491c02cf211dcec8cf87cc26ce2561d7b05c Mon Sep 17 00:00:00 2001
From: Huong Nguyen <huongnv13@gmail.com>
Date: Fri, 19 Sep 2025 15:33:36 +0700
Subject: [PATCH] NOBUG: Add upgrade notes

---
 UPGRADING.md               | 16 ++++++++++++++++
 course/format/UPGRADING.md |  8 ++++++++
 grade/UPGRADING.md         |  8 ++++++++
 3 files changed, 32 insertions(+)

diff --git a/UPGRADING.md b/UPGRADING.md
index 3dd93ad96ce..d5ac0f35ce8 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -41,6 +41,22 @@ The format of this change log follows the advice given at [Keep a CHANGELOG](htt
 
   For more information see [MDL-86311](https://tracker.moodle.org/browse/MDL-86311)
 
+### core_courseformat
+
+#### Added
+
+- Add a new modinfo::get_instance_of() to retrieve an instance of a cm via its name and instance id. Add a new modinfo::sort_cm_array() to sort an array of cms in their order of appearance in the course page. Replaces calls to get_course_and_cm_from_instance() and get_instances_of() whenever it was just used to retrieve a single instance of a cm.
+
+  For more information see [MDL-86021](https://tracker.moodle.org/browse/MDL-86021)
+
+### core_grades
+
+#### Added
+
+- - New grade_item::is_gradable function has been created to return whether the grade item is GRADE_TYPE_VALUE or GRADE_TYPE_SCALE.
+
+  For more information see [MDL-86173](https://tracker.moodle.org/browse/MDL-86173)
+
 ### theme_boost
 
 #### Added
diff --git a/course/format/UPGRADING.md b/course/format/UPGRADING.md
index f9ab3c26ecb..e9810cc2e4c 100644
--- a/course/format/UPGRADING.md
+++ b/course/format/UPGRADING.md
@@ -1,5 +1,13 @@
 # core_courseformat (subsystem / plugintype) Upgrade notes
 
+## 5.0.2+
+
+### Added
+
+- Add a new modinfo::get_instance_of() to retrieve an instance of a cm via its name and instance id. Add a new modinfo::sort_cm_array() to sort an array of cms in their order of appearance in the course page. Replaces calls to get_course_and_cm_from_instance() and get_instances_of() whenever it was just used to retrieve a single instance of a cm.
+
+  For more information see [MDL-86021](https://tracker.moodle.org/browse/MDL-86021)
+
 ## 5.0
 
 ### Added
diff --git a/grade/UPGRADING.md b/grade/UPGRADING.md
index 8b510a415d6..fcdca435aa1 100644
--- a/grade/UPGRADING.md
+++ b/grade/UPGRADING.md
@@ -1,5 +1,13 @@
 # core_grades (subsystem) Upgrade notes
 
+## 5.0.2+
+
+### Added
+
+- - New grade_item::is_gradable function has been created to return whether the grade item is GRADE_TYPE_VALUE or GRADE_TYPE_SCALE.
+
+  For more information see [MDL-86173](https://tracker.moodle.org/browse/MDL-86173)
+
 ## 5.0
 
 ### Added