diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index c38064a04ee..126bb2dc35d 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -1,6 +1,13 @@
 This files describes API changes in core libraries and APIs,
 information provided here is intended especially for developers.
 
+=== 3.0.1 ===
+
+* Number of changes to allow to run Moodle on PHP7. This should not affect existing plugins
+  when running on PHP5 but it is recommended to ensure PHP7 compatibility in plugins as well.
+  From Moodle 3.1 calling parent constructors by class names will show deprecation warnings.
+  Refer to https://docs.moodle.org/dev/Moodle_and_PHP7 for more information.
+
 === 3.0 ===
 
 * Minify updated to 2.2.1