Moodle release 5.0.1

Prepend the current tab name to the page title, to ensure we can
easily identify the current page/tab and that it is both unique
and accessible.

.github/workflows/onebyone.yml

@@ -113,7 +113,7 @@ jobs:
           cp .github/workflows/config-template.php config.php
           mkdir ../moodledata
           sudo locale-gen en_AU.UTF-8
-          php public/admin/tool/phpunit/cli/init.php --no-composer-self-update
+          php admin/tool/phpunit/cli/init.php --no-composer-self-update
 
       - name: Run PHPUnit test (one by one)
         env:

.github/workflows/push.yml

@@ -19,7 +19,7 @@ env:
 
 jobs:
   Grunt:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-22.04
 
     steps:
       - name: Checking out code
@@ -61,12 +61,12 @@ jobs:
       matrix:
         include:
           # MySQL builds always run with the lowest PHP supported version.
-          - os: ubuntu-24.04
+          - os: ubuntu-22.04
             php: 8.2
             extensions:
             db: mysqli
           # PostgreSQL builds always run with the highest PHP supported version.
-          - os: ubuntu-24.04
+          - os: ubuntu-22.04
             php: 8.4
             db: pgsql
 
@@ -88,7 +88,7 @@ jobs:
         if: ${{ matrix.db == 'pgsql' }}
         uses: m4nu56/postgresql-action@v1
         with:
-          postgresql version: 15
+          postgresql version: 14
           postgresql db: test
           postgresql user: test
           postgresql password: test
@@ -115,7 +115,7 @@ jobs:
           cp .github/workflows/config-template.php config.php
           mkdir ../moodledata
           sudo locale-gen en_AU.UTF-8
-          php public/admin/tool/phpunit/cli/init.php --no-composer-self-update
+          php admin/tool/phpunit/cli/init.php --no-composer-self-update
 
       - name: Running PHPUnit tests
         env:

.github/workflows/windows.yml

@@ -140,7 +140,7 @@ jobs:
           echo "pathtophp=$(which php)" >> $GITHUB_ENV # Inject installed pathtophp to env. The template config needs it.
           cp .github/workflows/config-template.php config.php
           mkdir ../moodledata
-          php public/admin/tool/phpunit/cli/init.php --no-composer-self-update
+          php admin/tool/phpunit/cli/init.php --no-composer-self-update
 
       - name: Running PHPUnit tests
         env:

.gitignore

@@ -43,9 +43,9 @@ composer.phar
 /vendor/
 /behat.yml
 */yui/build/*/*-coverage.js
-/public/lib/yuilib/*/build/*/*-coverage.js
+/lib/yuilib/*/build/*/*-coverage.js
 # lib/yuilib/version/module/module-coverage.js
-/public/lib/yuilib/*/*/*-coverage.js
+/lib/yuilib/*/*/*-coverage.js
 atlassian-ide-plugin.xml
 /node_modules/
 /.vscode/
@@ -53,8 +53,8 @@ moodle-plugin-ci.phar
 .eslintignore
 .stylelintignore
 /jsdoc
-/public/admin/tool/componentlibrary/docs
-/public/admin/tool/componentlibrary/hugo/site/data/my-index.json
+/admin/tool/componentlibrary/docs
+/admin/tool/componentlibrary/hugo/site/data/my-index.json
 .hugo_build.lock
 phpcs.xml
 jsconfig.json

.grunt/components.js

@@ -47,7 +47,7 @@ const fetchComponentData = () => {
         const components = JSON.parse(fs.readFileSync(`${gruntFilePath}/lib/components.json`));
         const pluginData = JSON.parse(fs.readFileSync(`${gruntFilePath}/lib/plugins.json`));
 
-        componentData.pluginTypes = components.plugintypes
+        componentData.pluginTypes = components.plugintypes;
 
         const standardPlugins = Object.entries(pluginData.standard).map(
             ([pluginType, pluginNames]) => {
@@ -56,21 +56,18 @@ const fetchComponentData = () => {
         ).reduce((acc, val) => acc.concat(val), []);
 
         // Build the list of moodle subsystems.
-        componentData.subsystems['public/lib'] = 'core';
-        componentData.pathList.push(`${process.cwd()}/public/lib`);
+        componentData.subsystems.lib = 'core';
+        componentData.pathList.push(process.cwd() + path.sep + 'lib');
         for (const [component, thisPath] of Object.entries(components.subsystems)) {
             if (thisPath) {
                 // Prefix "core_" to the front of the subsystems.
                 componentData.subsystems[thisPath] = `core_${component}`;
-                componentData.pathList.push(`${process.cwd()}/${thisPath}`);
+                componentData.pathList.push(process.cwd() + path.sep + thisPath);
             }
         }
 
         // The list of components includes the list of subsystems.
-        componentData.components = Object.fromEntries(
-            Object.entries(componentData.subsystems)
-            .map(([path, name]) => ([path, name]))
-        );
+        componentData.components = {...componentData.subsystems};
 
         const subpluginAdder = (subpluginType, subpluginTypePath) => {
             glob.sync(`${subpluginTypePath}/*/version.php`).forEach(versionPath => {
@@ -107,7 +104,7 @@ const fetchComponentData = () => {
                         });
                     } else if (subpluginList.plugintypes) {
                         Object.entries(subpluginList.plugintypes).forEach(([subpluginType, subpluginTypePath]) => {
-                            subpluginAdder(subpluginType, `public/${subpluginTypePath}`);
+                            subpluginAdder(subpluginType, subpluginTypePath);
                         });
                     }
                 }

.grunt/notes/src/helpers.mjs

@@ -217,7 +217,7 @@ const getInitialMessageValue = (options) => {
 export const getCurrentVersion = async () => {
     const versionRegex = new RegExp(/^ *\$release *= *['\"](?<release>[^ \+]+\+?) *\(Build:.*/m);
     try {
-        const versionFile = await readFile('public/version.php', 'utf8');
+        const versionFile = await readFile('version.php', 'utf8');
         const match = versionFile.match(versionRegex);
         if (match) {
             return match.groups.release;

.grunt/notes/src/releasenotes.mjs

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-// This file is part of Moodle - http://moodle.org/
-//
-// Moodle is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// Moodle is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
-
-import { getAllComponents } from './components.mjs';
-import { getCombinedNotesByComponent } from './note.mjs';
-import logger from './logger.mjs';
-import { existsSync } from 'fs';
-
-/**
- * Generate links to component-specific upgrade notes for each component.
- *
- * @param {string|undefined} tag The git tag to link to
- * @returns {Promise<void>}
- */
-export default async (tag) => {
-    const notes = await getCombinedNotesByComponent();
-
-    if (Object.keys(notes).length === 0) {
-        logger.warn('No notes to generate');
-        return;
-    }
-
-    if (!tag) {
-        logger.error('No tag provided');
-        return;
-    }
-
-    // Generate the links for the components which have upgrade notes in this release.
-    let upgradeNotes = `### Component API updates\n<!--cspell: disable -->\n\n`;
-
-    const componentList = Object.fromEntries(
-        Object.values(getAllComponents()).map(({path, value}) => [value, path]),
-    );
-    Object.entries(notes)
-    .map(([component]) => ({
-        component,
-        componentPath: componentList[component],
-    }))
-    .filter(({ componentPath }) => existsSync(`./${componentPath}/UPGRADING.md`))
-    .forEach(({component, componentPath}) => {
-        upgradeNotes += `- [${component}](https://github.com/moodle/moodle/blob/${tag}/${componentPath}/UPGRADING.md)\n`;
-    });
-
-    console.log(upgradeNotes);
-};

.grunt/tasks/componentlibrary.js

@@ -30,7 +30,7 @@ module.exports = grunt => {
      * @param   {string} path
      * @returns {string}
      */
-    const getCLPath = path => `public/admin/tool/componentlibrary/${path}`;
+    const getCLPath = path => `admin/tool/componentlibrary/${path}`;
 
     /**
      * Get a spawn handler.
@@ -97,7 +97,7 @@ module.exports = grunt => {
         '--source-map',
         '--embed-sources',
         '--precision', 6,
-        '--load-path', `${process.cwd()}/public`,
+        '--load-path', process.cwd(),
         getCLPath('hugo/scss/docs.scss'),
         getCLPath('hugo/dist/css/docs.css'),
     ]);

.grunt/tasks/ignorefiles.js

@@ -84,10 +84,10 @@ module.exports = grunt => {
         const stylelintIgnores = [
             '# Generated by "grunt ignorefiles"',
             '**/yui/build/*',
-            'public/theme/boost/style/moodle.css',
-            'public/theme/classic/style/moodle.css',
+            'theme/boost/style/moodle.css',
+            'theme/classic/style/moodle.css',
             'jsdoc/styles/*.css',
-            'public/admin/tool/componentlibrary/hugo/dist/css/docs.css',
+            'admin/tool/componentlibrary/hugo/dist/css/docs.css',
         ].concat(thirdPartyPaths);
         grunt.file.write('.stylelintignore', stylelintIgnores.join('\n') + '\n');
 

.grunt/tasks/jsconfig.js

@@ -43,8 +43,8 @@ module.exports = (grunt) => {
 
         const componentData = fetchComponentData().components;
         for (const [thisPath, component] of Object.entries(componentData)) {
-            jsconfigData.compilerOptions.paths[`${component}/*`] = [`public/${thisPath}/amd/src/*`];
-            jsconfigData.include.push(`public/${thisPath}/amd/src/**/*`);
+            jsconfigData.compilerOptions.paths[`${component}/*`] = [`${thisPath}/amd/src/*`];
+            jsconfigData.include.push(`${thisPath}/amd/src/**/*`);
         }
 
         grunt.file.write('jsconfig.json', JSON.stringify(jsconfigData, null, "  ") + "\n");

.grunt/tasks/sass.js

@@ -27,16 +27,13 @@ module.exports = grunt => {
         sass: {
             dist: {
                 files: {
-                    "public/theme/boost/style/moodle.css": "public/theme/boost/scss/preset/default.scss",
-                    "public/theme/classic/style/moodle.css": "public/theme/classic/scss/classicgrunt.scss"
+                    "theme/boost/style/moodle.css": "theme/boost/scss/preset/default.scss",
+                    "theme/classic/style/moodle.css": "theme/classic/scss/classicgrunt.scss"
                 }
             },
             options: {
                 implementation: require('sass'),
-                includePaths: [
-                    "public/theme/boost/scss/",
-                    "public/theme/classic/scss/",
-                ]
+                includePaths: ["theme/boost/scss/", "theme/classic/scss/"]
             }
         },
     });

.grunt/upgradenotes.mjs

@@ -20,7 +20,6 @@ import chalk from 'chalk';
 import { getNoteNames } from './notes/src/noteTypes.mjs';
 import createAction from './notes/src/create.mjs';
 import generateAction from './notes/src/generate.mjs';
-import generateReleaseNotesLinks from './notes/src/releasenotes.mjs';
 import logger from './notes/src/logger.mjs';
 
 console.log(`
@@ -75,13 +74,6 @@ program
         new Argument('[version]', 'The Moodle version to create the summary notes for')
     )
     .action((version) => generateAction(version));
-program
-    .command('releasenotes')
-    .summary('Generate a list of upgrade notes for individual components in markdown format for the release notes')
-    .addArgument(
-        new Argument('[tag]', 'The Moodle tag')
-    )
-    .action((tag) => generateReleaseNotesLinks(tag));
 
 program
     .command('release')

.upgradenotes/MDL-31071-2024090219200626.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-31071
-notes:
-  core:
-    - message: >-
-        The following function has been deprecated and should no longer be used:
-        `file_encode_url`. Please consider using the `core\url` factory methods
-        instead.
-      type: deprecated

.upgradenotes/MDL-41924-2025022812015134.yml

@@ -1,17 +0,0 @@
-issueNumber: MDL-41924
-notes:
-  core_question:
-    - message: >
-        The question backup API has been improved to only include questions that
-        are actually used or owned by backed up activities.
-
-        Any activities that use question references should be supported
-        automatically. Activities that use *question set references* (for
-        example, random quiz questions) need to add a call to
-        `backup_question_set_reference_trait::annotate_set_reference_bank_entries()`
-        alongside the call to
-        `backup_question_set_reference_trait::add_question_set_references()` in
-        their backup step. See
-        `backup_quiz_activity_structure_step::define_structure()` for an
-        example.
-      type: improved

.upgradenotes/MDL-72123-2025061202210420.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-72123
-notes:
-  core_message:
-    - message: >
-        The web service `core_message_get_member_info` additionally returns
-        `cancreatecontact` which is a boolean value for a user's permission to
-        add a contact.
-      type: improved

.upgradenotes/MDL-76612-2025021015492066.yml

@@ -1,46 +0,0 @@
-issueNumber: MDL-76612
-notes:
-  mod_quiz:
-    - message: >
-        Final deprecations for the quiz. The following files have been removed:
-          - mod/quiz/accessmanager_form.php
-          - mod/quiz/accessmanager.php
-          - mod/quiz/accessrule/accessrulebase.php
-          - mod/quiz/attemptlib.php
-          - mod/quiz/cronlib.php
-          - mod/quiz/override_form.php
-          - mod/quiz/renderer.php
-          - mod/quiz/report/attemptsreport_form.php
-          - mod/quiz/report/attemptsreport_options.php
-          - mod/quiz/report/attemptsreport_table.php
-          - mod/quiz/report/attemptsreport.php
-          - mod/quiz/report/default.php
-      type: removed
-    - message: >
-       Final deprecations for the quiz. The following methods have been removed:
-          - mod_quiz\output\renderer::no_questions_message
-          - mod_quiz\output\renderer::render_mod_quiz_links_to_other_attempts
-          - mod_quiz\output\renderer::render_quiz_nav_question_button
-          - mod_quiz\output\renderer::render_quiz_nav_section_heading
-          - mod_quiz\structure::get_slot_tags_for_slot_id
-          - mod_quiz\structure::is_display_number_customised
-      type: removed
-    - message: >
-        Final deprecations for the quiz. The following functions have been removed:
-          - quiz_has_question_use
-          - quiz_update_sumgrades
-          - quiz_update_all_attempt_sumgrades
-          - quiz_update_all_final_grades
-          - quiz_set_grade
-          - quiz_save_best_grade
-          - quiz_calculate_best_grade
-          - quiz_calculate_best_attempt
-      type: deprecated
-    - message: >
-        Final deprecations for the quiz. The following classes have been removed:
-          - mod_quiz_overdue_attempt_updater
-          - moodle_quiz_exception
-      type: removed
-    - message: >-
-        The const quiz_statistics\calculator::TIME_TO_CACHE has been removed.
-      type: removed

.upgradenotes/MDL-77307-2025021219361043.yml

@@ -1,12 +0,0 @@
-issueNumber: MDL-77307
-notes:
-  core_grades:
-    - message: >-
-        The previously deprecate methods have been removed:
-          - grade_structure::get_grade_analysis_icon
-          - grade_structure::get_reset_icon
-          - grade_structure::get_edit_icon
-          - grade_structure::get_hiding_icon
-          - grade_structure::get_locking_icon
-          - grade_structure::get_calculation_icon
-      type: removed

.upgradenotes/MDL-77307-2025022715052932.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-77307
-notes:
-  gradereport_grader:
-    - message: |+
-        The previously deprecated methods have been removed:
-          - grade_report_grader::get_left_icons_row
-          - grade_report_grader::get_right_icons_row
-          - grade_report_grader::get_icons
-      type: removed

.upgradenotes/MDL-78091-2025022518040058.yml

@@ -1,11 +0,0 @@
-issueNumber: MDL-78091
-notes:
-  mod_quiz:
-    - message: >-
-        Final deprecation of:
-          - mod_quiz\form\add_random_form::class
-          - mod_quiz\local\structure\slot_random::set_tags()
-          - mod_quiz\local\structure\slot_random::set_tags_by_id()
-          - const quiz_statistics\calculator::TIME_TO_CACHE
-          - quiz_add_random_questions()
-      type: removed

.upgradenotes/MDL-78091-2025022518040101.yml

@@ -1,21 +0,0 @@
-issueNumber: MDL-78091
-notes:
-  core_question:
-    - message: >-
-        Final deprecation of:
-          - core_question\local\bank\random_question_loader::get_next_question_id()
-          - core_question\local\bank\random_question_loader::get_category_key()
-          - core_question\local\bank\random_question_loader::ensure_questions_for_category_loaded()
-          - core_question\local\bank\random_question_loader::get_question_ids()
-          - core_question\local\bank\random_question_loader::is_question_available()
-          - core_question\local\bank\random_question_loader::get_questions()
-          - core_question\local\bank\random_question_loader::count_questions()
-          - core_question\local\bank\view::display_top_pagnation()
-          - core_question\local\bank\view::display_bottom_pagination()
-          - question_finder::get_questions_from_categories_with_usage_counts()
-          - question_finder::get_questions_from_categories_and_tags_with_usage_counts()
-      type: removed
-    - message: >-
-        Intial deprecation of core_question_bank_renderer::render_question_pagination() and the associated template file.
-        Rendering the question pagination is now done via ajax based pagination.
-      type: deprecated

.upgradenotes/MDL-78091-2025030810083886.yml

@@ -1,13 +0,0 @@
-issueNumber: MDL-78091
-notes:
-  mod_quiz:
-    - message: >
-        Initial deprecation add_random_form and associates.
-
-        The just removed mod_quiz\form\add_random_form was the only place in
-        core where the mod_quiz/add_random_form javascript was called, so we can
-        deprecate this now. This also enables us to deprecate the
-        mod_quiz/random_question_form_preview javascript and the
-        mod_quiz/random_question_form_preview_question_list template as they are
-        direct dependends.
-      type: deprecated

.upgradenotes/MDL-78375-2025021311242423.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-78375
-notes:
-  core:
-    - message: >
-        Final deprecation of device related theme methods. The following two methods have been
-        removed from the core_useragent class:
-          - core_useragent::get_device_type_theme
-          - core_useragent::get_device_type_cfg_var_name
-      type: removed

.upgradenotes/MDL-79052-2025021313220016.yml

@@ -1,11 +0,0 @@
-issueNumber: MDL-79052
-notes:
-  core:
-    - message: >
-        Final deprecation of removing the legacy theme settings.
-        The following method has been removed:
-          - core_useragent::get_device_type_list()
-        The following classes have been removed:
-          - core_adminpresets\local\setting\adminpresets_admin_setting_devicedetectregex
-          - admin_setting_devicedetectregex
-      type: removed

.upgradenotes/MDL-79319-2025061007521538.yml

@@ -1,10 +0,0 @@
-issueNumber: MDL-79319
-notes:
-  theme_boost:
-    - message: >-
-        Theme can now inherit from their grand-parent and parents. 
-        So if a child theme inherit from a parent theme that declares a new
-        layout, the child theme can use it without redeclaring it.
-        Also inheritance for layout uses the expected grandparent > parent >
-        child with precedence to the child theme.
-      type: improved

.upgradenotes/MDL-79756-2024111602135099.yml

@@ -1,43 +0,0 @@
-issueNumber: MDL-79756
-notes:
-  core:
-    - message: >
-        Changes were implemented to make `checkbox-toggleall` output component
-        more inclusive:
-
-
-        * Replace the references to `master` checkboxes with `toggler`.
-
-        * Replace the references to `slave` checkboxes with `target`.
-      type: changed
-    - message: >+
-        The following `core/checkbox-toggleall` templates have been deprecated:
-
-
-        - `core/checkbox-toggleall-master-button` - This is replaced with
-        `core/checkbox-toggleall-toggler-button`
-
-        - `core/checkbox-toggleall-master` - This is replaced with
-        `core/checkbox-toggleall-toggler`
-
-        - `core/checkbox-toggleall-slave` - This is replaced with
-        `core/checkbox-toggleall-target`
-
-
-        The following items in the `core/checkbox-toggleall` JS module have been
-        deprecated:
-
-
-        - Method:
-            - `updateSlavesFromMasterState()` - This is replaced with `updateTargetsFromTogglerState()`.
-
-        - Usage of the following selectors:
-            - `data-toggle=master` - This is replaced with `data-toggle=toggler`.
-            - `data-toggle=slave` - This is replaced with `data-toggle=target`.
-
-        The usage of these selectors will continue to be supported until they
-        are removed by final deprecation. In the meantime, a deprecation warning
-        in the JavaScript console will be shown if usage of these selectors is
-        detected.
-
-      type: deprecated

.upgradenotes/MDL-79756-2024111812030302.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-79756
-notes:
-  mod_scorm:
-    - message: >
-        The method `\mod_scorm\report::generate_master_checkbox()` has been
-        deprecated and should no longer be used. SCORM report plugins calling
-        this method should use `\mod_scorm\report::generate_toggler_checkbox()`
-        instead.
-      type: deprecated

.upgradenotes/MDL-80295-2025081402174966.yml

@@ -1,13 +0,0 @@
-issueNumber: MDL-80295
-notes:
-  core_course:
-    - message: >-
-        The core_course_get_course_content_items is now deprecated. Use
-        core_courseformat_get_section_content_items instead.
-      type: deprecated
-  core_courseformat:
-    - message: >-
-        From now on, the activity chooser will use
-        core_courseformat_get_section_content_items to get the available modules
-        for a specific section
-      type: improved

.upgradenotes/MDL-80295-2025081402214016.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-80295
-notes:
-  core_course:
-    - message: >-
-        The course_section_add_cm_control course renderer method is deprecated.
-        Use section_add_cm_controls instead.
-      type: deprecated

.upgradenotes/MDL-80295-2025082810094335.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-80295
-notes:
-  core_course:
-    - message: >-
-        Passing the section number (integer) to the
-        core_course\output\activitychooserbutton is deprecated. You must use a
-        core_course\section_info instead.
-      type: deprecated

.upgradenotes/MDL-80295-2025082810134999.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-80295
-notes:
-  core_course:
-    - message: >-
-        The getModulesData and activityModules methods from
-        core_course/local/activitychooser/repository are deprecated. Use
-        getSectionModulesData and sectionActivityModules instead
-      type: deprecated

.upgradenotes/MDL-80327-2025021314480342.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-80327
-notes:
-  mod_quiz:
-    - message: >
-        Removed the deprecated class callbacks `quiz_structure_modified` and `quiz_attempt_deleted` from mod_quiz,
-        use the `structure_modified` and `attempt_state_changed` hooks instead. These callbacks were deprecated in
-        Moodle 4.4 and were outputting deprecation warnings since then.
-      type: removed

.upgradenotes/MDL-80327-2025070911261611.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-80327
-notes:
-  core:
-    - message: >
-        Removed `core\hook\manager::is_deprecated_plugin_callback()` in favor of
-        `core\hook\manager::get_hooks_deprecating_plugin_callback()`.
-      type: removed

.upgradenotes/MDL-80380-2025052104135989.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-80380
-notes:
-  core_auth:
-    - message: >
-        A new method called `get_additional_upgrade_token_parameters` has been
-        added to `oauth2_client` class. This will allow custom clients to
-        override this one and add their extra parameters for upgrade token
-        request.
-      type: improved

.upgradenotes/MDL-80455-2025021310392511.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-80455
-notes:
-  core_badges:
-    - message: >-
-        Final removal of core_badges_renderer::render_badge_collection() and
-        core_badges_renderer::render_badge_recipients()
-      type: removed

.upgradenotes/MDL-80556-2025070802320223.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-80556
-notes:
-  core_block:
-    - message: Removed block_section_links from Moodle 5.1.
-      type: removed

.upgradenotes/MDL-82132-2025041514493372.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-82132
-notes:
-  core_user:
-    - message: >-
-        New method `\core_user::get_dummy_fullname(...)` for returning dummy
-        user fullname comprised of configured name fields only
-      type: improved

.upgradenotes/MDL-82159-2025073102000443.yml

@@ -1,23 +0,0 @@
-issueNumber: MDL-82159
-notes:
-  core:
-    - message: |+
-        The following classes have been renamed and now support autoloading.
-        Existing classes are currently unaffected.
-
-        | Old class name                  | New class name                                  |
-        | ---                             | ---                                             |
-        | `\breadcrumb_navigation_node`   | `\core\navigation\breadcrumb_navigation_node`   |
-        | `\flat_navigation_node`         | `\core\navigation\flat_navigation_node`         |
-        | `\flat_navigation`              | `\core\navigation\flat_navigation_node`         |
-        | `\global_navigation_for_ajax`   | `\core\navigation\global_navigation_for_ajax`   |
-        | `\global_navigation`            | `\core\navigation\global_navigation`            |
-        | `\navbar`                       | `\core\navigation\navbar`                       |
-        | `\navigation_cache`             | `\core\navigation\navigation_cache`             |
-        | `\navigation_json`              | `\core\navigation\navigation_json`              |
-        | `\navigation_node_collection`   | `\core\navigation\navigation_node_collection`   |
-        | `\navigation_node`              | `\core\navigation\navigation_node`              |
-        | `\settings_navigation_for_ajax` | `\core\navigation\settings_navigation_for_ajax` |
-        | `\settings_navigation`          | `\core\navigation\settings_navigation`          |
-
-      type: improved

.upgradenotes/MDL-82159-2025080707392534.yml

@@ -1,12 +0,0 @@
-issueNumber: MDL-82159
-notes:
-  core:
-    - message: |
-        The following global constants have been deprecated in favour of class
-        constants:
-
-         | Old constant                       | New constant                                              |
-         | ---                                | ---                                                       |
-         | `NAVIGATION_CACHE_NAME`            | `\core\navigation\navigation_node::CACHE_NAME`            |
-         | `NAVIGATION_SITE_ADMIN_CACHE_NAME` | `\core\navigation\navigation_node::SITE_ADMIN_CACHE_NAME` |
-      type: deprecated

.upgradenotes/MDL-82322-2025073102510933.yml

@@ -1,11 +0,0 @@
-issueNumber: MDL-82322
-notes:
-  core_course:
-    - message: |
-        The following classes have been renamed and now support autoloading.
-        Existing classes are currently unaffected.
-
-         | Old class name    | New class name                |
-         | ---               | ---                           |
-         | `\course_request` | `\core_course\course_request` |
-      type: improved

.upgradenotes/MDL-82381-2025022716072475.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-82381
-notes:
-  report_progress:
-    - message: Added a new optional parameter $activegroup to render_groups_select()
-      type: changed

.upgradenotes/MDL-82464-2024071510291847.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-82464
-notes:
-  core_reportbuilder:
-    - message: >-
-        The `count[distinct]` aggregation types support optional `'callback'`
-        value to customise the formatted output when applied to columns
-      type: improved

.upgradenotes/MDL-83080-2024121715070347.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83080
-notes:
-  core_message:
-    - message: >-
-        The `contexturl` property to `\core\message\message` instances can now
-        contain `\core\url` values in addition to plain strings
-      type: improved

.upgradenotes/MDL-83081-2025041010204344.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83081
-notes:
-  mod_label:
-    - message: >-
-        The dndmedia setting has been removed. From now on dropping a media file
-        into a course will always ask the user if they want to create a label.
-      type: removed

.upgradenotes/MDL-83147-2025011910580324.yml

@@ -1,14 +0,0 @@
-issueNumber: MDL-83147
-notes:
-  core_ai:
-    - message: >-
-        Error message handler for AI subsystem.
-
-        - Object creation
-          Use `core_ai\error\factory::create($errorcode, $reason, $errorsource)` to generate the appropriate error object.
-
-        - Extensibility
-          Add new error types by extending `core_ai\error\base` and registering them in the factory.
-          Please see `core_ai\error\ratelimit` as an example.
-
-      type: improved

.upgradenotes/MDL-83448-2025031805112717.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-83448
-notes:
-  core:
-    - message: >
-        - Added is_site_registered_in_hub method in lib/classes/hub/api.php to
-          check if the site is registered or not.
-        - Added get_secret method in lib/classes/hub/registration.php to get site's secret.
-      type: improved

.upgradenotes/MDL-83838-2024121110301123.yml

@@ -1,6 +0,0 @@
-issueNumber: MDL-83838
-notes:
-  report_progress:
-    - message: >
-        Add download widget for report to download multiple formats.
-      type: improved

.upgradenotes/MDL-83838-2024121110301124.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83838
-notes:
-  report_progress:
-    - message: >
-        `report_progress\output\renderer::render_download_buttons`
-        No replacement. We no longer need to render the download custom button links.
-      type: deprecated

.upgradenotes/MDL-83887-2025072401461409.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-83887
-notes:
-  core_block:
-    - message: Removed block_activity_modules from Moodle 5.1.
-      type: removed

.upgradenotes/MDL-83889-2025080108444783.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-83889
-notes:
-  mod_bigbluebuttonbn:
-    - message: Add activity_dates class to BigblueButton module.
-      type: improved

.upgradenotes/MDL-83890-2025052604224378.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-83890
-notes:
-  mod_choice:
-    - message: >-
-        Add manager class to the mod_choice activity. For now this is only for
-        the purpose of implementing the activity overview page but can be
-        improved to be used elsewhere.
-      type: improved

.upgradenotes/MDL-83890-2025061607042821.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-83890
-notes:
-  mod_choice:
-    - message: Add new generator for choice responses
-      type: improved

.upgradenotes/MDL-83891-2025052810092895.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-83891
-notes:
-  mod_data:
-    - message: Database entries generator could create 'approved' entries.
-      type: improved

.upgradenotes/MDL-83891-2025061310444666.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-83891
-notes:
-  mod_data:
-    - message: >-
-        New get_approval_requested(), get_all_entries(),
-        filter_entries_by_user(), filter_entries_by_approval() and
-        get_comments() functions have been added to mod_data manager class.
-      type: improved

.upgradenotes/MDL-83893-2025062706495797.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83893
-notes:
-  mod_forum:
-    - message: >-
-        The function forum_tp_get_untracked_forums() has been deprecated because
-        it is no longer used.
-      type: deprecated

.upgradenotes/MDL-83896-2025060212250840.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-83896
-notes:
-  core_courseformat:
-    - message: >-
-        Added new core_courseformat\output\local\overview\overviewdialog output
-        class to create dialog elements in the course overview page. Overview
-        dialog will display a combination of title, description and a list
-        of items (label: value).
-      type: improved

.upgradenotes/MDL-83896-2025061812521463.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83896
-notes:
-  mod_lesson:
-    - message: >-
-        Added new 'count_all_submissions', 'count_submitted_participants' and
-        'count_all_participants' functions needed by the overview page.
-      type: improved

.upgradenotes/MDL-83898-2025071507584336.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-83898
-notes:
-  mod_quiz:
-    - message: >-
-        Add helper methods in the mod/quiz/lib.php to count the number of
-        attempts (quiz_num_attempts), the number of users who attempted a quiz
-        (quiz_num_users_who_attempted) and users who can attempt
-        (quiz_num_users_who_can_attempt)
-      type: improved

.upgradenotes/MDL-83899-2025061709145972.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83899
-notes:
-  mod_scorm:
-    - message: >-
-        Create a manager class to regroup common functionalities for course
-        overview page
-      type: improved

.upgradenotes/MDL-83899-2025061907380930.yml

@@ -1,5 +0,0 @@
-issueNumber: MDL-83899
-notes:
-  mod_scorm:
-    - message: Add a new generator for scorm attempts to simulate user's attempt.
-      type: improved

.upgradenotes/MDL-83900-2025052719455356.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-83900
-notes:
-  mod_wiki:
-    - message: >-
-        Create a manager class to regroup common functionalities and a wiki_mode
-        enum related to the two different modes
-      type: improved

.upgradenotes/MDL-83904-2025032008552774.yml

@@ -1,10 +0,0 @@
-issueNumber: MDL-83904
-notes:
-  core_badges:
-    - message: >-
-        The class core_badges_observer in badges/classes/observer.php has been moved to 
-        core_badges\event\observer in badges/classes/event/observer.php. A compatibility 
-        layer has been added to maintain backward compatibility, but direct use of the old 
-        class name is now deprecated. If you've extended or directly used the old class, 
-        you should update your code to use the new namespaced class.
-      type: improved

.upgradenotes/MDL-84071-2025010603085830.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-84071
-notes:
-  gradereport_singleview:
-    - message: >
-        The `grade/report/singleview/js/singleview.js` file has been removed. And the
-        `grade/report/singleview/amd/src/singleview.js` file has been added. The new file
-        is converted from YUI to native JS.
-
-      type: improved

.upgradenotes/MDL-84216-2025041006111773.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84216
-notes:
-  core_course:
-    - message: >
-        The duplicatesection param in course/view.php is deprecated. Use
-        course/format/update.php with action section_duplicate instead.
-      type: deprecated

.upgradenotes/MDL-84291-2025042303303788.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84291
-notes:
-  core_courseformat:
-    - message: >-
-        The maxsections setting is now considered deprecated and will be removed
-        in Moodle 6.0. Consider implementing your own setting in your format
-        plugin if needed.
-      type: deprecated

.upgradenotes/MDL-84291-2025042902162982.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84291
-notes:
-  format_weeks:
-    - message: >-
-        The weekly sections format now has a system setting called Maximum
-        initial number of weeks that replaced the old "Max sections" when
-        creating a new course
-      type: improved

.upgradenotes/MDL-84291-2025042902174752.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84291
-notes:
-  format_topics:
-    - message: >-
-        Now the custom sections format won't ask for initial sections on the
-        creation form. Instead it will use the system number of sections
-        settings directly.
-      type: improved

.upgradenotes/MDL-84291-2025051308320419.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84291
-notes:
-  core_courseformat:
-    - message: >-
-        The param $maxsections of get_num_sections_data in addsection output is
-        not used anymore. If your format overrides this method, you should add
-        a default value 0 to be consistent with the new implementation.
-      type: changed

.upgradenotes/MDL-84291-2025060310563124.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84291
-notes:
-  core_courseformat:
-    - message: >-
-        The format base method get_max_sections has been deprecated, as the
-        maxsections setting is also deprecated and no longer in use.
-      type: deprecated

.upgradenotes/MDL-84442-2025042111220326.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84442
-notes:
-  core:
-    - message: >-
-        Added a new optional param to adhoc_task_failed and
-        scheduled_task_failed to allow skipping log finalisation when called
-        from a separate task.
-      type: improved

.upgradenotes/MDL-84464-2025071010020648.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-84464
-notes:
-  core:
-    - message: >-
-        Add a new method has_valid_group in \core\report_helper that will return
-        true or false depending if the user has a valid group. This is mainly
-        false in case the user is not in any group in SEPARATEGROUPS. Used in
-        report_log and report_loglive
-      type: improved

.upgradenotes/MDL-84531-2025061213382940.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84531
-notes:
-  core:
-    - message: >-
-        The `\core\attribute\deprecated` attribute constructor `$replacement`
-        parameter now defaults to null, and can be omitted
-      type: changed

.upgradenotes/MDL-84548-2025021618002455.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84548
-notes:
-  mod_qbank:
-    - message: >
-        The bulk_action_base class has gotten a get_bulk_action_classes function
-        to let bulk actions specify additional classes to add to the bulk action
-        menu entry. If none is defined in the child, '' is returned.
-      type: changed

.upgradenotes/MDL-84632-2025082011493425.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_book:
-    - message: >-
-        The \mod_book\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84632-2025082011495797.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_folder:
-    - message: >-
-        The \mod_folder\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84632-2025082011501476.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_imscp:
-    - message: >-
-        The \mod_imscp\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84632-2025082011503346.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_page:
-    - message: >-
-        The \mod_page\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84632-2025082011505355.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_resource:
-    - message: >-
-        The \mod_resource\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84632-2025082011510960.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84632
-notes:
-  mod_url:
-    - message: >-
-        The \mod_url\event\course_module_instance_list_viewed event is now
-        deprecated. Use \core\event\course_resources_list_viewed instead.
-      type: deprecated

.upgradenotes/MDL-84779-2025042903491664.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84779
-notes:
-  core_ai:
-    - message: >-
-        The method `has_model_settings` inside `core_ai\aimodel\base`
-        is now determined by values returned from a new method called
-        `get_model_settings`.
-      type: changed

.upgradenotes/MDL-84804-2025060412115860.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-84804
-notes:
-  core:
-    - message: >-
-        There is a new `core/page_title` Javascript module for manipulating the
-        current page title
-      type: improved

.upgradenotes/MDL-84809-2025082110281911.yml

@@ -1,12 +0,0 @@
-issueNumber: MDL-84809
-notes:
-  mod_workshop:
-    - message: >-
-        The function `workshop::count_submissions` has been deprecated and
-        should no longer be used, use `workshop::count_all_submissions`
-        instead.
-      type: deprecated
-    - message: >-
-        The function `workshop::count_assessments` has been deprecated and
-        should no longer be used, use `workshop::count_all_assessments` instead.
-      type: deprecated

.upgradenotes/MDL-84948-2025032410354799.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-84948
-notes:
-  core:
-    - message: >-
-        The `core_plugin_manager::plugintype_name[_plural]` methods now require
-        language strings for plugin types always be defined via `type_<type>`
-        and `type_<type>_plural` language strings
-      type: changed

.upgradenotes/MDL-85069-2025060213180503.yml

@@ -1,19 +0,0 @@
-issueNumber: MDL-85069
-notes:
-  core_question:
-    - message: >
-        `core_question_search_shared_banks` will now search all question banks,
-        not just those outside the current course.
-
-        This makes the service usable in cases outside of the current "Switch
-        banks" UI, which require searching all banks on the site.
-
-        It also makes the autocomplete in the "Switch banks" UI more consistent,
-        as it was previously excluding some of the banks listed in the UI
-        (Question banks in this course), but not others (Recently viewed
-        question banks).
-
-        This change has also adds a 'requiredcapabilties' parameter to the
-        function, which accepts an list of abbreviated capabilities for 
-        checking access against question banks before they are returned.
-      type: changed

.upgradenotes/MDL-85146-2025081405080057.yml

@@ -1,11 +0,0 @@
-issueNumber: MDL-85146
-notes:
-  theme_boost:
-    - message: >-
-        The `core:e/text_highlight` and `core:e/text_highlight_picker` icons are
-        deprecated and will be removed in Moodle 6.0.
-        The UX team recommended this change to reduce visual clutter and improve
-        readability. The icons were removed because they didn't indicate status
-        changes, were repetitive across all notifications, and took up space that
-        could be used for more content.
-      type: deprecated

.upgradenotes/MDL-85158-2025042205481782.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85158
-notes:
-  core:
-    - message: >-
-        Added support for configurable `aspectRatio` in charts rendered using
-        Chart.js. This enables developers to control chart sizing more precisely
-        via the `chart_base` API and the frontend renderer.
-      type: improved

.upgradenotes/MDL-85216-2025041619113672.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-85216
-notes:
-  core_reportbuilder:
-    - message: >-
-        The `report_action` class now accepts a `pix_icon` to include inside the
-        rendered action element
-      type: improved

.upgradenotes/MDL-85240-2025051111233235.yml

@@ -1,10 +0,0 @@
-issueNumber: MDL-85240
-notes:
-  qtype_multichoice:
-    - message: >-
-        Restrict override of margin-bottom for fitem_id_answer_* and
-        fitem_id_fraction_* divs to own edit form. Question type
-        plugins currently benefitting from the unlimited style override
-        will need to change their styles.css accordingly. An example
-        can be found in calculatedmulti's style sheet.
-      type: changed

.upgradenotes/MDL-85284-2025082107474534.yml

@@ -1,13 +0,0 @@
-issueNumber: MDL-85284
-notes:
-  core_course:
-    - message: >-
-        The changenumsections.php script is deprecated. Please use
-        course/format/update.php instead.
-      type: deprecated
-  core_courseformat:
-    - message: >-
-        The course format "numsections" option to increment and decrement the
-        number of sections of the course one by one is now deprecated and will
-        be removed in Moodle 6.0.
-      type: deprecated

.upgradenotes/MDL-85392-2025052204331192.yml

@@ -1,10 +0,0 @@
-issueNumber: MDL-85392
-notes:
-  block_site_main_menu:
-    - message: >-
-        The "Main menu" block has been renamed to "Additional activities." Its
-        title is now customizable, and it can be used in course formats without
-        a dedicated view page (for instance, Single activity). On the Home page,
-        this block has also been renamed; administrators will need to manually
-        revert the name if they wish to retain "Main menu" after upgrading.
-      type: improved

.upgradenotes/MDL-85433-2025060303222827.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-85433
-notes:
-  core_course:
-    - message: >-
-        The 'Show description' checkbox is now present in all course formats.
-        Activity descriptions can be displayed via the Additional activities block
-        (formerly the Main menu block), regardless of whether the course
-        format's has_view_page() function returns false.
-      type: changed

.upgradenotes/MDL-85433-2025060405592009.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85433
-notes:
-  core_courseformat:
-    - message: >-
-        A new interface, `main_activity_interface`, is now available. Course
-        format plugins should implement it if they intend to display only a
-        single activity in the course page.
-      type: improved

.upgradenotes/MDL-85433-2025061202204883.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85433
-notes:
-  core_block:
-    - message: >-
-        Subcontext visibility is now turned on by default when adding blocks.
-        This change makes it much easier to manage blocks, for example, in
-        courses that lack a view page.
-      type: changed

.upgradenotes/MDL-85436-2025061603213110.yml

@@ -1,12 +0,0 @@
-issueNumber: MDL-85436
-notes:
-  theme:
-    - message: >-
-        These icons are no longer in use and have been deprecated:
-          - core:e/insert_col_after
-          - core:e/insert_col_before
-          - core:e/split_cells
-          - core:e/text_color
-          - core:t/locktime
-          - tool_policy/level
-      type: deprecated

.upgradenotes/MDL-85509-2025072401224706.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85509
-notes:
-  core_courseformat:
-    - message: >-
-        The core_courseformat\local\overview\overviewfactory now includes a new
-        method, activity_has_overview_integration, which determines if a module
-        supports overview integration.
-      type: improved

.upgradenotes/MDL-85509-2025072401261089.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85509
-notes:
-  core:
-    - message: >-
-        Output classes can now implement the core\output\externable interface.
-        This allows these classes to define methods for exporting their data in a format
-        suitable for use in web services.
-      type: improved

.upgradenotes/MDL-85518-2025061307102302.yml

@@ -1,10 +0,0 @@
-issueNumber: MDL-85518
-notes:
-  core_admin:
-  - message: >
-        - Added `searchmatchtype` property to `admin_settings`
-          to track search match type.
-        - Plugins that extend either `admin_settings` or `admin_externalpage`
-          are encouraged to specify a search match type from the available
-          types in `admin_search`.
-    type: improved

.upgradenotes/MDL-85533-2025052201591951.yml

@@ -1,7 +0,0 @@
-issueNumber: MDL-85533
-notes:
-  core_course:
-    - message: >-
-        The activitychoosertabmode setting has been removed. Consider
-        implementing your own setting in your theme if needed.
-      type: removed

.upgradenotes/MDL-85556-2025052709221269.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85556
-notes:
-  core_question:
-    - message: >
-        The unit test repeated\_restore\_test::test\_restore\_course\_with\_same\_stamp\_questions was passing incorrectly on 5.x for question types that use answers.
-
-        Maintainers of third-party question types may want to re-run the test with the fix in place, or if they have copied parts of this test as the basis of a test in their own plugin, review the changes and see if they should be reflected in their own test.
-      type: fixed

.upgradenotes/MDL-85598-2025082610105597.yml

@@ -1,8 +0,0 @@
-issueNumber: MDL-85598
-notes:
-  core_course:
-    - message: >-
-        Activities can now specify an additional purpose in their
-        PLUGINNAME_supports function by using the new FEATURE_MOD_OTHERPURPOSE
-        feature.
-      type: improved

.upgradenotes/MDL-85660-2025070903232232.yml

@@ -1,9 +0,0 @@
-issueNumber: MDL-85660
-notes:
-  format_social:
-    - message: >-
-        The social course format is now disabled by default for all new and
-        upgraded installations. Existing courses using this format will continue
-        to function, but administrators must re-enable it to create new social
-        courses.
-      type: deprecated