diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index c5fcef596a6..49c871e5f9a 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -4,6 +4,9 @@ information provided here is intended especially for developers.
 === 3.2 ===
 
 * Admin setting "Show My courses expanded on Dashboard" has been removed.
+* Some backwards and forwards compatibility has been added for different bootstrap versions.
+  This is to allow the same markup to work in "clean" and "boost" themes alot of the time. It is also to allow user text
+  with bootstrap classes to keep working in the new theme. See MDL-56004 for the list of supported classes.
 * MForms element 'submitlink' has been deprecated.
 * Node.js versions >=4 are now required to run grunt.
 * JQuery has been updated to 3.1.0. JQuery migrate plugins are no longer shipped - please read