diff --git a/auth/db/upgrade.txt b/auth/db/upgrade.txt
index b2a79c7a88d02..160f41f4f11f4 100644
--- a/auth/db/upgrade.txt
+++ b/auth/db/upgrade.txt
@@ -3,5 +3,8 @@ information provided here is intended especially for developers.
 
 === 2.9 ===
 
-* Plain text password matching is now always case sensitive, it does not
-  depend on the database sensitiveness anymore.
+Some alterations have been made to the handling of case sensitity handling of passwords
+and password hashes which previously varied depending on database configuration:
+
+* Plain text password matching is now always case sensitive
+* Password hash comparisons are now case insensitive