NOBUG: Add upgrade notes

course/UPGRADING.md

@@ -1,29 +1,31 @@
 # core_course (subsystem) Upgrade notes
 
-## 4.5rc1
+## 4.5rc2
 
 ### Added
 
-- - New optional `sectionNum` parameter has been added to `activitychooser` AMD module initializer. - New option `sectionnum` parameter has been added to `get_course_content_items()` external function. - New optional `sectionnum` parameter has been added to `get_content_items_for_user_in_course()` function.
+- - New optional `sectionNum` parameter has been added to `activitychooser` AMD module initializer.
+  - New option `sectionnum` parameter has been added to `get_course_content_items()` external function.
+  - New optional `sectionnum` parameter has been added to `get_content_items_for_user_in_course()` function.
 
   For more information see [MDL-81675](https://tracker.moodle.org/browse/MDL-81675)
-- Webservices `core_course_get_courses_by_field` now accepts a new parameter `sectionid` to be able to retrieve the course that has the indicated section
+- The `core_course_get_courses_by_field` web service now accepts a new parameter `sectionid` to be able to retrieve the course that has the indicated section.
 
   For more information see [MDL-81699](https://tracker.moodle.org/browse/MDL-81699)
 - Added new `activitychooserbutton` output class to display the activitychooser button. New `action_links` can be added to the button via hooks converting it into a dropdown.
 
   For more information see [MDL-81767](https://tracker.moodle.org/browse/MDL-81767)
-- New `\core_course\hook\before_activitychooserbutton_exported` hook added to allow third-party plugins to extend activity chooser button options
+- New `\core_course\hook\before_activitychooserbutton_exported` hook added to allow third-party plugins to extend activity chooser button options.
 
   For more information see [MDL-81767](https://tracker.moodle.org/browse/MDL-81767)
 - The following methods have been updated to accept a section name in addition to the section number:
-  - `i_open_section_edit_menu()`
-  - `i_show_section()`
-  - `i_hide_section(),`
-  - `i_wait_until_section_is_available()`
-  - `show_section_link_exists()`
-  - `hide_section_link_exists()`
-  - `section_exists()`
+  - `\behat_course::i_open_section_edit_menu()`
+  - `\behat_course::i_show_section()`
+  - `\behat_course::i_hide_section(),`
+  - `\behat_course::i_wait_until_section_is_available()`
+  - `\behat_course::show_section_link_exists()`
+  - `\behat_course::hide_section_link_exists()`
+  - `\behat_course::section_exists()`
 
   For more information see [MDL-82259](https://tracker.moodle.org/browse/MDL-82259)
 
@@ -35,7 +37,7 @@
   - Review all the strings used in the reset page to remove the "Delete" or "Remove" words from them.
 
   For more information see [MDL-81872](https://tracker.moodle.org/browse/MDL-81872)
-- The external function `core_course::get_course_contents` now returns the `component` and `itemid` of sections.
+- The external function `core_course_get_contents` now returns the `component` and `itemid` of sections.
 
   For more information see [MDL-82385](https://tracker.moodle.org/browse/MDL-82385)
 
@@ -50,7 +52,7 @@
 
 ### Removed
 
-- The previously deprecated `print_course_request_buttons` method has been removed and can no longer be used
+- The previously deprecated `\print_course_request_buttons()` method has been removed and can no longer be used.
 
   For more information see [MDL-73976](https://tracker.moodle.org/browse/MDL-73976)
 - The `$course` class property in the `\core_course\output\actionbar\group_selector` class has been removed.

course/format/UPGRADING.md

@@ -1,6 +1,6 @@
 # core_courseformat (subsystem / plugintype) Upgrade notes
 
-## 4.5rc1
+## 4.5rc2
 
 ### Added
 
@@ -8,15 +8,23 @@
   If `istrackeduser` is pre-computed for the course module's course, it can be provided here to avoid an additional function call.
 
   For more information see [MDL-81610](https://tracker.moodle.org/browse/MDL-81610)
-- Added new `create_module` webservice to create new module (with quickcreate feature) instances in the course.
+- Added new `core_courseformat_create_module` webservice to create new module (with quickcreate feature) instances in the course.
 
   For more information see [MDL-81767](https://tracker.moodle.org/browse/MDL-81767)
-- New `$disabled` parameter has been added to `select`, `select_optgroup` and `select_option` html_writers to create disabled option elements.
+- A new `$disabled` parameter has been added to the following `html_writer` methods:
+
+  - `\core\output\html_writer::select()`
+  - `\core\output\html_writer::select_optgroup()`
+  - `\core\output\html_writer::select_option()`
 
   For more information see [MDL-82146](https://tracker.moodle.org/browse/MDL-82146)
-- New `\core_courseformat\output\local\content\basecontrolmenu` class has been created. Existing `\core_courseformat\output\local\content\cm\controlmenu` and `\core_courseformat\output\local\content\section\controlmenu` classes extend the new `\core_courseformat\output\local\content\basecontrolmenu` class.
+- A new class, `\core_courseformat\output\local\content\basecontrolmenu`, has been created.
+  The following existing classes extend the new class:
+
+   - `\core_courseformat\output\local\content\cm\controlmenu`
+   - `\core_courseformat\output\local\content\section\controlmenu`
 
   For more information see [MDL-82510](https://tracker.moodle.org/browse/MDL-82510)
-- New `\core_courseformat\output\local\content\cm\delegatedcontrolmenu` class has been created extending `\core_courseformat\output\local\content\basecontrolmenu` class to render delegated section action menu combining section and module action menu.
+- Course sections now use an action menu to display possible actions that a user may take in each section. This action menu is rendered using the `\core_courseformat\output\local\content\cm\delegatedcontrolmenu` renderable class.
 
   For more information see [MDL-82510](https://tracker.moodle.org/browse/MDL-82510)