From 5f654ea2c01fd16461d53602cb98959e0e42bfb3 Mon Sep 17 00:00:00 2001
From: David Monllao <davidm@moodle.com>
Date: Fri, 2 Dec 2016 09:24:35 +0800
Subject: [PATCH] MDL-57243 search: Note about search area base classes
 relocation

---
 lib/db/renamedclasses.php | 1 +
 search/upgrade.txt        | 9 +++++++++
 2 files changed, 10 insertions(+)
 create mode 100644 search/upgrade.txt

diff --git a/lib/db/renamedclasses.php b/lib/db/renamedclasses.php
index b12deba8919..70080fcd5ea 100644
--- a/lib/db/renamedclasses.php
+++ b/lib/db/renamedclasses.php
@@ -35,6 +35,7 @@ defined('MOODLE_INTERNAL') || die();
 // Like other files in the db directory this file uses an array.
 // The old class name is the key, the new class name is the value.
 // The array must be called $renamedclasses.
+// @todo MDL-57244 These renamed classes will be removed in 3.6
 $renamedclasses = array(
     'core\progress\null' => 'core\progress\none',
     'core_search\area\base' => 'core_search\base',
diff --git a/search/upgrade.txt b/search/upgrade.txt
new file mode 100644
index 00000000000..94d0d69fbc3
--- /dev/null
+++ b/search/upgrade.txt
@@ -0,0 +1,9 @@
+This files describes API changes in /search/*,
+information provided here is intended especially for developers.
+
+=== 3.2 ===
+
+* Base search area classes have been renamed, please update your search areas to use the classes below:
+  - \core_search\area\base has been renamed to \core_search\base
+  - \core_search\area\base_mod has been renamed to \core_search\base_mod
+  - \core_search\area\base_activity has been renamed to \core_search\base_activity